Odpowiedź serwera 405 Method Not Allowed

Co to jest kod statusu 405

Kod statusu HTTP 405 (Method Not Allowed) wskazuje, że metoda żądania używana przez klienta nie jest obsługiwana dla żądanych zasobów. Taki błąd może prowadzić do nieporozumień, szczególnie gdy programiści nie znają przyczyn jego wystąpienia.

Definicja i znaczenie

Kod 405 oznacza, że serwer rozumie metodę żądania, ale nie pozwala na jej zastosowanie do określonego zasobu. W praktyce, oznacza to, że zasób może być dostępny tylko dla określonych metod, takich jak GET, POST, PUT czy DELETE.

Scenariusze, kiedy występuje błąd 405

• Użycie metody POST zamiast GET do pobrania danych.
• Próba aktualizacji zasobu metodą DELETE, gdy zasób tylko akceptuje PUT.
• Błąd w adresie URL, który nie odpowiada zasobowi obsługującemu daną metodę.

Praktyczne przykłady wystąpienia błędu 405

1. Błąd przy użyciu metody POST zamiast GET

Na przykład, jeśli klient próbuje uzyskać dane z serwera, używając metody POST, podczas gdy serwer obsługuje tylko metodę GET, otrzyma odpowiedź 405.

2. Błąd przy próbie użycia metody PUT

Jeżeli zasób jest skonfigurowany do obsługi tylko PUT, a klient próbuje go zmodyfikować za pomocą metody POST, również otrzyma status 405.

3. Przykład z nieprawidłowym URL i metodą żądania

Jeśli żądanie jest kierowane do URL, który nie istnieje lub nie obsługuje danej metody, serwer zwróci kod 405. Na przykład, URL /api/user nie obsługuje metody DELETE.

Naprawa błędu 405 w różnych językach programowania

PHP

W PHP można sprawdzić metodę żądania i zwrócić odpowiedni status, np.:

if ($_SERVER['REQUEST_METHOD'] !== 'GET') {
    http_response_code(405);
    echo 'Method Not Allowed';
}

W przypadku frameworków, takich jak Laravel, można ustawić obsługę metod w zdefiniowanych trasach.

JavaScript (Node.js)

W Node.js używając Express, można zdefiniować trasy oraz zwracać odpowiednie kody statusu:

app.get('/api/resource', (req, res) => {
    res.send('Resource accessed');
});

app.post('/api/resource', (req, res) => {
    res.status(405).send('Method Not Allowed');
});

Python (Flask)

W Flask można ustawić trasy i obsługiwać metody w następujący sposób:

@app.route('/api/resource', methods=['GET'])
def get_resource():
    return 'Resource accessed'

@app.route('/api/resource', methods=['POST'])
def post_resource():
    return 'Method Not Allowed', 405

Dekoratory mogą być używane do określenia dozwolonych metod.

Często występujące błędy i sposoby ich zapobiegania

• Niewłaściwa konfiguracja serwera.
• Błędy w trasowaniu aplikacji.
• Rekomendacje dotyczące testowania API pod kątem poprawności metod.

Rekomendacje dotyczące obsługi statusu 405

Aby powiadomić użytkowników o nieprawidłowych metodach, można zwrócić jasny komunikat błędu. Ważne jest, aby dokumentacja API była zrozumiała dla programistów, co ułatwi im korzystanie z dostępnych metod.

Ustawienie logowania w celu śledzenia błędów 405 pomoże w szybkim diagnozowaniu problemów w aplikacji.

Metoda	Opis	Kod statusu
GET	Pobranie danych z serwera	200
POST	Wysłanie danych na serwer	201
PUT	Aktualizacja istniejących danych	204
DELETE	Usunięcie danych	204
Nieprawidłowa metoda	Metoda nieobsługiwana przez zasób	405

Dodatkowe kody

Kod	Opis
405.0	Metoda niedozwolona - Użyta metoda żądania nie jest dozwolona.