Skip to main content

Подключение и использование публичного API

Для использования публичного апи Wheelies администратор организации должен настроить домены и получить уникальный ключ публичного API.

Шаг 1. Получение ключа публичного API

Для работы с публичным API необходимо получить уникальный ключ API. Для этого нужно:

Шаг 2. Добавление доменов

Для безопасности API необходимо указать список доверенных доменов, с которых разрешены запросы. Без указания доменов API будет возвращать ошибку доступа. Для этого нужно:

  • Авторизоваться на сайте demo.wheelies.ru

  • Перейти на страницу настроек организации demo.wheelies.ru/settings.

  • Укажите корректный базовый домен, с которого будут поступать запросы (например, mydomain.ru). Обратите внимание: если вы укажете некорректный домен, вы не сможете использовать API Wheelies.
    Если вы хотите, чтобы использовались поддомены, необходимо поставить в начале базового домена точку (например, .mydomain.ru).
    Вы также можете указать несколько доменных имен, если есть необходимость использовать API на разных доменах.

  • Нажмите кнопку Сохранить

Шаг 3. Использование ключа API в запросах

Убедитесь, что ваши приложения отправляют:

  • Заголовок Origin или Referer и он совпадает с указанным в настройках доменом.

  • Ключ apiKey в параметрах запроса.

В противном случае запросы будут считаться «неизвестными» и отклоняться.

Пример запроса:
curl -L 'https://demo.wheelies.ru/api/auth/login?apiKey=0198bb1d-bb8c-79c8-a5b5-5a4b9c3f4431'
-H 'Content-Type: application/json'
-H 'Accept: application/json'
-H "Origin: https://mydomain.ru"
-H "Referer: https://mydomain.ru"
--data-raw
{ "login": "example@mail.ru", "password": "123456" }