Аутентификация клиента включает следующие шаги:

1. Регистрация приложения: Вы должны зарегистрировать свое приложение на странице — https://leader-id.ru/developers. В процессе регистрации вы получите идентификатор клиента (client_id) и секретный ключ клиента (client_secret), которые будут использоваться для аутентификации вашего приложения.

2. Получение токена доступа: Используя полученные идентификаторы и ключи, выполните запрос к API. Если запрос проходит успешно, сервер авторизации выдаст вашему приложению токен доступа.

3. Использование токена доступа: Ваше приложение может использовать полученный токен доступа для вызова API.

Получение токена доступа (access_token)

Для аутентификации клиента и получение сервисного access_token необходимо выполнить POST запрос к методу «Получить токен для доступа к API» с передачей идентификаторов вашего приложения client_id, client_secret и параметра grant_type со значение client_credentials.

POST:

https://apps.leader-id.ru/api/v1/oauth/token

Тело запроса:

{
    "client_id": "KEY",
    "client_secret": "SECRET",
    "grant_type": "client_credentials"
}

Ответ сервера будет содержать user_id — идентификатор пользователя, user_validated — флаг, указывающий на успешную проверку подлинности пользователя, refresh_token — токен для обновления access_token и access_token — токен доступа к API, который может быть использован для авторизации при выполнении запросов к API.

{
    "user_id": 000000,
    "user_validated": true,
    "refresh_token": "eyJ0eXAiO...",
    "access_token": "eyJ0eXAiO..."
}

В случае ошибки будут переданы параметры error и error_description:

{
    "error_description": "Code is out of date!",
    "error": "unauthorized_client"
}

Обновление токена доступа (`refresh_token`)

Для обновления access_token с помощью refresh_token необходимо выполнить POST запрос по методу Получить токен для доступа к API с передачей параметра refresh_token.

https://apps.leader-id.ru/api/v1/oauth/token

Пример тела запроса:

{
    "client_id": "KEY",
    "client_secret": "SECRET",
    "grant_type": "refresh_token",
    "refresh_token": "REFRESH_TOKEN"
}

В результате выполнения запроса будет получен новый access_token с ограниченным временем действия — 7 суток и новый refresh_token для последующего обновления access_token .

Пример ответа:

{
    "user_id": 123456,
    "user_validated": true,
    "refresh_token": "eyJ0eXA_______",
    "access_token": "eyJ0eXA_______"
}

Примеры запросов к API Leader-ID

Поиск города с использованием GET запроса по методу Поиск города по названию:

https://apps.leader-id.ru/api/v1/cities/search?q=Москва

В заголовке (headers) запроса необходимо указывать access_token

Authorization: Bearer eyJ0eXAiO...

Пример ответа:

[
    {
    "id": 881,
    "name": "Москва",
    "priority": 433795,
    "postal_code": null,
    "area_id": null,
    "name_search": "'москв':1",
    "dadata_name": "Москва",
    "okato": "45000000000",
    "okato_searched": true,
    "is_capital": true,
    "region":
        {
        "id": 4000,
        "name": "Москва",
        "priority": 330721,
        "fias_code": null,
        "timezone": "+0300",
        "dadata_name": "Москва",
        "iso_code": "RU-MOW",
        "okato": "45000000000",
        "country":
            {
            "id": 160,
            "name": "Россия",
            "priority": 1971164,
            "dadata_name": "Россия"
            }
        }
    }
]

В начало

Powered by Froala Editor

Client credentials (Аутентификация клиента)