Palauttaa pyynnön metodin ja sisällön. Hyväksyy JSONin, pelkän tekstin, yksinkertaiset lomaketiedot ja binääridatan.
Lisätiedot
Esimerkkipyynnöt
POST · JSON
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: application/json' \
--data-binary '{"name":"Bob"}'
POST · Pelkkä teksti
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: text/plain' \
--data-binary 'Hello!'
POST · Lomake
curl 'http://localhost:3000/v1/echo' \
--data-urlencode 'name=Bob' \
--data-urlencode 'age=42'
POST · Binääritiedosto
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: application/octet-stream' \
--data-binary '@./file.bin'
Vastaukset
200 OK
Pyynnön metodi ja jäsennetty sisältö. Tässä esimerkissä on GET-pyyntö ilman sisältöä.
Esimerkki · text/plain
GET
null
Esimerkki · application/json
{
"method": "GET",
"body": null
}
Skeema · object
| Kenttä | Tyyppi | Kuvaus |
|---|
methodpakollinen | string | Pyynnön HTTP-metodi. |
|---|
bodypakollinen | object | array | string | number | boolean | null | JSON-arvo, merkkijono, lomakekentät tai binäärisisältö { encoding: 'base64', sizeBytes: number, data: string }. null, jos sisältöä ei ole. |
|---|
body · binääriobjekti
| Kenttä | Tyyppi | Kuvaus |
|---|
encodingpakollinen | string | Aina "base64". |
|---|
sizeBytespakollinen | integer | Alkuperäisten tavujen määrä. |
|---|
datapakollinen | string | Base64-koodattu sisältö. |
|---|
400 Bad Request
Virheellinen format-arvo, esimerkiksi ?format=xml. Tämä virhe palautetaan aina pelkkänä tekstinä.
Esimerkki · text/plain
Unsupported format: xml
Valid values: text, json
Esimerkki · text/plain
Unsupported format: xml
Valid values: text, json
413 Payload Too Large
Sisältö ylittää 102 400 tavua (100 KiB).
Esimerkki · text/plain
Request body exceeds the size limit of 100 KiB
Esimerkki · application/json
{
"error": "Request body exceeds the size limit of 100 KiB",
"limitBytes": 102400
}
Skeema · object
| Kenttä | Tyyppi | Kuvaus |
|---|
errorpakollinen | string | Virheen kuvaus. |
|---|
limitBytespakollinen | integer | Pyynnön sisällön enimmäiskoko tavuina. Arvo: 102400. |
|---|
415 Unsupported Media Type
Content-Type puuttuu tai sitä ei tueta, vaikka pyynnössä on sisältöä.
Esimerkki · text/plain
Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream
Esimerkki · application/json
{
"error": "Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream"
}
Skeema · object
| Kenttä | Tyyppi | Kuvaus |
|---|
errorpakollinen | string | Virheen kuvaus. |
|---|
Virheellinen JSON palauttaa myös koodin 400. Jäsentimen syntaksi- ja merkistökoodausvirheet käyttävät toistaiseksi Expressin oletusarvoista HTML-vastausta valitusta vastausmuodosta riippumatta.