Zwraca metodę i treść żądania. Obsługuje JSON, zwykły tekst, proste dane formularza i dane binarne.
Szczegóły
Przykłady żądań
POST · JSON
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: application/json' \
--data-binary '{"name":"Bob"}'
POST · Zwykły tekst
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: text/plain' \
--data-binary 'Hello!'
POST · Formularz
curl 'http://localhost:3000/v1/echo' \
--data-urlencode 'name=Bob' \
--data-urlencode 'age=42'
POST · Plik binarny
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: application/octet-stream' \
--data-binary '@./file.bin'
Odpowiedzi
200 OK
Metoda i przetworzona treść żądania. Ten przykład przedstawia żądanie GET bez treści.
Przykład · text/plain
GET
null
Przykład · application/json
{
"method": "GET",
"body": null
}
Schemat · object
| Pole | Typ | Opis |
|---|
methodwymagane | string | Metoda HTTP żądania. |
|---|
bodywymagane | object | array | string | number | boolean | null | Wartość JSON, ciąg znaków, pola formularza lub dane binarne { encoding: 'base64', sizeBytes: number, data: string }. Bez treści: null. |
|---|
body · obiekt binarny
| Pole | Typ | Opis |
|---|
encodingwymagane | string | Zawsze "base64". |
|---|
sizeByteswymagane | integer | Liczba oryginalnych bajtów. |
|---|
datawymagane | string | Treść zakodowana w Base64. |
|---|
400 Bad Request
Nieprawidłowy format, np. ?format=xml. Ten błąd jest zawsze zwracany jako zwykły tekst.
Przykład · text/plain
Unsupported format: xml
Valid values: text, json
Przykład · text/plain
Unsupported format: xml
Valid values: text, json
413 Payload Too Large
Treść przekracza 102 400 bajtów (100 KiB).
Przykład · text/plain
Request body exceeds the size limit of 100 KiB
Przykład · application/json
{
"error": "Request body exceeds the size limit of 100 KiB",
"limitBytes": 102400
}
Schemat · object
| Pole | Typ | Opis |
|---|
errorwymagane | string | Opis błędu. |
|---|
limitByteswymagane | integer | Maksymalny rozmiar treści w bajtach. Wartość: 102400. |
|---|
415 Unsupported Media Type
Nieobsługiwany lub brakujący Content-Type dla niepustej treści.
Przykład · text/plain
Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream
Przykład · application/json
{
"error": "Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream"
}
Schemat · object
| Pole | Typ | Opis |
|---|
errorwymagane | string | Opis błędu. |
|---|
Nieprawidłowy JSON również zwraca 400. Błędy składni i kodowania parsera obecnie zwracają domyślną odpowiedź HTML Express, niezależnie od wybranego formatu.