---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/en/delivery/quickstart/register.md
  - https://yandex.kz/routing/doc/kk/delivery/quickstart/register.md
  - https://yandex.kz/routing/doc/ru/delivery/quickstart/register.md
  - https://yandex.kz/routing/doc/tr/delivery/quickstart/register.md
  - href: kk/delivery/quickstart/register.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Яндекс Маршрутизация — порядок внедрения API — получение oauth-токена
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/kk/llms.txt


# Получение OAuth-токена

Для работы с API Мониторинга нужен OAuth-токен. Требования к OAuth-токену:

- Токен должен быть создан для пользователя, который является [администратором](https://yandex.kz/routing/doc/kk/delivery/interface/managers.md#user-roles) в компании.
- Токен не должен быть отозван. Подробнее см. в разделе [Время жизни токена](#lifetime).

Перед началом работы с API Мониторинга получите OAuth-токен:


#|
|| ![](./../_images/video-icon.png) | Получение OAuth-токена. Краткая инструкция

{% cut "Посмотреть видео" %}

@[rutube](https://rutube.ru/play/embed/f264e9d3f3a42c8ca32057aba30f7369)

{% endcut %}

||
|#


1. При необходимости создайте аккаунт с [Яндекс ID](https://passport.yandex.kz/registration). При регистрации используйте корпоративный или любой другой электронный адрес на Яндекс Почте.

2. Авторизуйтесь на Яндексе под логином, который будет использоваться для загрузки данных.

3. Откройте страницу [Доступ внешних приложений](https://oauth.yandex.ru/) и нажмите **Создать**.

4. Выберите опцию **Для доступа к API или отладки** и нажмите **Перейти к созданию**.
    

5. Заполните поле **Название вашего сервиса**. Название сервиса может быть любым. Оно появится в списке ваших приложений в сервисе OAuth для Яндекс ID. Иконку сервиса прикреплять не обязательно.

6. В поле **Почта для связи** укажите адрес электронной почты.

7. В поле **Название доступа** введите `courier:logistician`.

8. Нажмите **Создать приложение**. 

    Откроется страница приложения. Идентификатор приложения из поля **ClientID** потребуется для получения OAuth-токена.

    ![](./../_images/client-id.png){style="border: solid 1px #cccccc; max-width: 800px;"}

9. Получите OAuth-токен. Для этого:
    
    1. Перейдите по ссылке. Вместо `<ClientID-вашего-приложения>` подставьте значение из пункта 7.


       ```
       https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID-вашего-приложения>
       ```




    2. Проверьте, что сервис предлагает авторизоваться под нужным логином.
    3. Нажмите **Войти как <логин>**.
    4. Скопируйте последовательность символов, появившихся на экране — это и есть ваш OAuth-токен.
    5. Убедитесь, что токен работает. Для этого добавьте его в заголовок запроса:

    ```
    curl -H "Authorization: OAuth <ваш-OAuth-токен>" -X GET https://courier.yandex.ru/api/v1/test
    ```

    Ответом должно быть сообщение: `{"message":"OK"}`.

    Дополнительную информацию об OAuth можно найти в разделе [Реализация OAuth в Яндексе](https://yandex.ru/dev/id/doc/dg/oauth/concepts/ya-oauth-intro.html).



## Время жизни токена {#lifetime}

Время жизни токена не ограничено.

Токен может стать недействителен в следующих случаях:

- Он был отозван. Если ваш токен отозвали, вам нужно получить новый. О причинах отзыва см. в разделе [Отзыв токенов](https://yandex.ru/dev/id/doc/ru/tokens/token-invalidate).
- Пользователь сменил пароль учетной записи, на которую был выдан токен.
- Пользователь учетной записи, на которую был выдан токен, нажал кнопку **Выйти из всех сервисов Яндекса**.


## Решение проблем {#solving-problems}

#### Ошибка unauthorized_client при получении OAuth-токена

Ошибка возникает при получении OAuth-токена (пункт 8.1), если для вашего аккаунта есть ограничения. В этом случае отправьте обращение через [форму]( https://yandex.ru/dev/id/doc/ru/feedback). Служба поддержки примет решение о снятии ограничений и свяжется с вами.

{% note info %}

Перед заполнением формы убедитесь, что вы авторизованы под аккаунтом, для которого возникли ограничения, иначе форма не откроется.

{% endnote %}

<!-- source: kk/delivery/_includes/feedback.md -->


[//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))

<!-- source: kk/_includes/neuroexpert.md -->
<div style="display: none;"> </div>
<!-- endsource: kk/_includes/neuroexpert.md -->
<!-- endsource: kk/delivery/_includes/feedback.md -->