Zmieniająca stan
Metoda HTTP POST
Żądania POST wysyłają dane do przetworzenia przez serwer.
Znaczenie
Klient wysyła zawartość żądania do obsłużenia przez zasób docelowy.
Częste zastosowania
Używaj POST do przesyłania formularzy, operacji tworzenia, poleceń, przesyłania plików oraz przetwarzania, którego nie da się bezpiecznie powtórzyć.
Co sprawdzić
Sprawdź treść żądania, Content-Type, błędy walidacji oraz to, czy powtórzenie żądania wywołałoby kolejny efekt.
Przykładowe żądanie
POST /articles HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"New article"}Właściwości
- Bezpieczna
- Nie. Ta metoda może zmienić stan serwera.
- Idempotentna
- Nie. Powtórzenie żądania może wywołać kolejny efekt.
- Buforowalna
- Tylko wtedy, gdy odpowiedź wyraźnie na to pozwala.
- Treść żądania
- Zwykle tak
Źródła
- Rejestr
- IANA HTTP Method Registry
- Specyfikacja
- RFC 9110 Section 9.3.3
- Przewodnik
- MDN POST