HTTP-заголовки
В этом разделе описаны HTTP-заголовки, которые API будет принимать при любом запросе.
Content-Type
Все запросы должны содержать HTTP-заголовок content-type.
Принимаемые типы содержимого
| Базовый формат | Content-Types | Content-Types |
|---|---|---|
| JSON | приложение/json | text/json в настоящее время не является допустимым типом содержимого |
| Данные формы | multipart/form-data | Используется только при загрузке вариаций |
Ошибки типа содержимого
| Код ответа | Примечания |
|---|---|
| 400 | Тип содержимого был понят, но не смог быть декодирован. Дополнительная информация появится в теле ответа |
| 415 | Тип содержимого отсутствует или не поддерживается |
Примечание: В случаях, когда в заголовке content-type есть проблема, тип содержимого ответа будет иметь формат по умолчанию для API, в настоящее время application/json
Примечание: В настоящее время API не придерживается HTTP-заголовка Accept-type, все ответы отправляются с тем же типом содержимого, что и полученный запрос, при условии, что тип содержимого запроса был действительным
Авторизация
Этот заголовок является необязательным и используется для предоставления API аутентификационных данных для текущего пользователя, которые позволят ему получить доступ к ограниченным ресурсам API. Токены могут быть получены через API Login. Пример заголовка:
Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086
Заголовок Authorization принимает строку, состоящую из двух частей, разделенных одним пробелом. Первая часть - это тип токена, вторая - сам токен доступа.
Ошибки авторизации
| Код ответа | Примечания |
|---|---|
| 400 | Был предоставлен неверно сформированный заголовок авторизации |
| 401 | Заголовок авторизации отсутствует или токен был недействительным или истекшим |
Выбор типа маркера авторизации
В случае неудачи заголовки ответа будут содержать заголовок WWW-Authenticate, в котором будет указан тип токена, необходимый для доступа.