Skip to main content

Ключ API

Для аутентификации необходимо передавать заголовок pubrio-api-key. Заголовок должен содержать ключ API, например a1b2c3d4e5f6g7h8, который представляет ваш ключ API.
Чтобы получить доступ к Pubrio API, вам нужно создать ключ API. Сделать это можно в разделе Настройки.
Ключ API уже содержит информацию о вашей рабочей области (профиле), поэтому передавать profile_id в теле запроса не требуется. Параметр profile_id по-прежнему принимается для обратной совместимости, но больше не является обязательным.

Заголовки запроса

Вместе с pubrio-api-key отправляйте заголовок User-Agent, идентифицирующий вашего клиента.
Отсутствующий или слишком общий User-Agent отклоняется до того, как запрос дойдёт до API. Запросы без распознаваемого user agent блокируются на границе сети и возвращают HTTP 403 с телом в виде обычного текста error code: 1010 — это не JSON и не один из задокументированных кодов ошибок. Это выглядит как ошибка аутентификации, но ею не является: ваш ключ API в порядке.Затрагиваются user agent’ы по умолчанию из распространённых HTTP-библиотек — urllib Python (Python-urllib/3.x) блокируется, а curl и requests — нет. Если вы получаете error code: 1010, задайте явный User-Agent и повторите попытку.