HTTP-заголовки

В этом разделе описываются HTTP-заголовки, которые API будет принимать из любого запроса.

Content-Type

Все запросы должны содержать HTTP-заголовок content-type.

Допустимые типы Content-Type

Базовый формат	Типы Content-Type	Типы Content-Type
JSON	application/json	text/json в настоящее время не является допустимым типом содержимого
Данные формы	multipart/form-data	Используется только при загрузке вариаций

Ошибки Content-Type

Код ответа	Примечания
400	Тип содержимого был распознан, но не удалось его декодировать. Дополнительная информация будет отображена в теле ответа
415	Тип содержимого отсутствует или не поддерживается

Примечание: В случаях, когда есть проблема с заголовком content-type, тип содержимого ответа будет форматом по умолчанию для API, в настоящее время application/json

Примечание: В настоящее время API не следует HTTP-заголовку Accept-type: все ответы отправляются в том же типе содержимого, что и полученный запрос, при условии, что тип содержимого запроса был допустим

Авторизация

Этот заголовок необязателен и используется для передачи API сведений аутентификации для текущего пользователя, что позволит текущему пользователю получать доступ к ограниченным ресурсам API. Токены можно получить через API входа. Пример заголовка:

Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086

Заголовок Authorization принимает строку, которая состоит из двух частей, разделённых одним пробелом. Первая часть — это тип токена, вторая — сам токен доступа.

Ошибки авторизации

Код ответа	Примечания
400	Был предоставлен неверно сформированный заголовок авторизации
401	Заголовок авторизации отсутствует, либо токен был недействителен или истёк

Выбор типа токена авторизации

При любой ошибке в заголовках ответа будет содержаться заголовок WWW-Authenticate, который укажет тип токена, необходимый для доступа.