Передавайте заголовок Authorization: Bearer <key> в каждом вызове. Неверный ключ даёт 401; верный ключ без нужного scope для эндпоинта даёт 403.
Заголовок
Каждый запрос к внешнему API содержит заголовок Authorization со значением «Bearer» и ключом. Базовый URL и интерактивный справочник находятся на странице документации API; спецификация OpenAPI 3.1 доступна по адресу /openapi.json, её можно импортировать в Postman, Bruno или генератор клиентов для вашего языка.
Коды ответа
Без заголовка либо с неверным или отозванным ключом ответ 401. Если ключ действителен, но у него нет scope, который требует эндпоинт (например, POST /employees без employees:write), ответ 403, а в теле указано, какого scope не хватает. Ошибки валидации приходят как 422 со списком полей и сообщений на языке заголовка Accept-Language.
Язык и формат
Передайте Accept-Language (pt-BR, en, es, de или ru), чтобы получать переведённые сообщения об ошибках. Даты передаются и возвращаются в формате ISO 8601, денежные суммы как десятичные числа с указанием валюты, а ответы со списками разбиты на страницы.