Возвращает метод и тело запроса. Принимает JSON, обычный текст, простые формы и бинарные данные.
Подробнее
Примеры запросов
POST · JSON
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: application/json' \
--data-binary '{"name":"Bob"}'
POST · Обычный текст
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: text/plain' \
--data-binary 'Hello!'
POST · Форма
curl 'http://localhost:3000/v1/echo' \
--data-urlencode 'name=Bob' \
--data-urlencode 'age=42'
POST · Бинарный файл
curl 'http://localhost:3000/v1/echo' \
-H 'Content-Type: application/octet-stream' \
--data-binary '@./file.bin'
Ответы
200 OK
Метод и разобранное тело запроса. Пример ниже: GET без тела.
Пример · text/plain
GET
null
Пример · application/json
{
"method": "GET",
"body": null
}
Схема · object
| Поле | Тип | Описание |
|---|
methodобязательное | string | HTTP-метод запроса. |
|---|
bodyобязательное | object | array | string | number | boolean | null | JSON-значение, строка, поля формы или бинарное тело { encoding: 'base64', sizeBytes: number, data: string }. Без тела: null. |
|---|
body · бинарный объект
| Поле | Тип | Описание |
|---|
encodingобязательное | string | Всегда "base64". |
|---|
sizeBytesобязательное | integer | Количество исходных байтов. |
|---|
dataобязательное | string | Содержимое в Base64. |
|---|
400 Bad Request
Недопустимый format, например ?format=xml. Эта ошибка всегда возвращается обычным текстом.
Пример · text/plain
Unsupported format: xml
Valid values: text, json
Пример · text/plain
Unsupported format: xml
Valid values: text, json
413 Payload Too Large
Тело превышает 102 400 байт (100 КиБ).
Пример · text/plain
Request body exceeds the size limit of 100 KiB
Пример · application/json
{
"error": "Request body exceeds the size limit of 100 KiB",
"limitBytes": 102400
}
Схема · object
| Поле | Тип | Описание |
|---|
errorобязательное | string | Описание ошибки. |
|---|
limitBytesобязательное | integer | Максимальный размер тела в байтах. Значение: 102400. |
|---|
415 Unsupported Media Type
Неподдерживаемый или отсутствующий Content-Type у непустого тела.
Пример · text/plain
Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream
Пример · application/json
{
"error": "Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream"
}
Схема · object
| Поле | Тип | Описание |
|---|
errorобязательное | string | Описание ошибки. |
|---|
Некорректный JSON также возвращает 400. Ошибки синтаксиса и кодировки парсера пока используют стандартный HTML-ответ Express, независимо от выбранного формата.