---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.com/docs/en/mobile-api/intro/authorization.md
  - https://appmetrica.yandex.com/docs/ru/mobile-api/intro/authorization.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/ru/llms.txt

# Авторизация

Для использования API AppMetrica необходимо получить [авторизационный токен](https://tech.yandex.ru/oauth/doc/dg/concepts/ya-oauth-intro-docpage/) с помощью Яндекс.OAuth. Его необходимо передавать для каждого метода в HTTP-заголовке `Authorization`.

Пример:

{% list tabs %}

- cURL

  ```bash translate=no
  curl -X GET \
    https://api.appmetrica.yandex.com/management/v1/applications \
    -H 'Authorization: OAuth <your_token>'
  ```

  где `<your_token>` — это OAuth-токен, который можно получить по [инструкции](#get-oauth-token).

- HTTP

  ```httpget translate=no
  GET /management/v1/applications HTTP/1.1
  Host: api.appmetrica.yandex.com
  Authorization: OAuth <your_token>
  ```

  где `<your_token>` — это OAuth-токен, который можно получить по [инструкции](#get-oauth-token).

{% endlist %}

{% note alert "" %}

Передача токена в параметрах URL не поддерживается.

{% endnote %}

Если метод API вызван без токена или в запросе передан недействительный токен, сервер возвращает HTTP-статус `401 Unauthorized`.

## Получение OAuth-токена {#get-oauth-token}

Чтобы получить авторизационный токен:

1. Перейдите на страницу [создания приложения](https://oauth.yandex.com/client/new/api) в Яндекс ID.

    {% note alert "" %}

    Используйте ссылку из инструкции. Если открыть страницу из Яндекс ID, указать нужные доступы не получится.

    {% endnote %}

1. Укажите название вашего сервиса.
1. Укажите почту для связи. 
1. В разделе **Доступ к данным** укажите `appmetrica:read` и `appmetrica:write`. Чтобы доступы появились в выпадающем списке, начните вводить их название.

    {% cut "Скриншот" %}

    ![Доступ к данным](../../../_images/access-data-ru.png){width=500px}{style="border: solid 1px #cccccc;"}

    {% endcut %}

1. Нажмите **Создать приложение**. После создания приложения откроется окно с информацией о нем.

1. Скопируйте идентификатор вашего приложения в блоке **ClientID**.

    {% cut "Скриншот" %}

    ![ClientID](../../../_images/clientid-copy-ru.png){width=500px}{style="border: solid 1px #cccccc;"}

    {% endcut %}

1. Вставьте его в ссылку, чтобы получить отладочный токен:

    ```
    https://oauth.yandex.com/authorize?response_type=token&client_id=<идентификатор приложения>
    ```

Подробнее об авторизации с помощью OAuth [в документации сервиса](https://tech.yandex.ru/oauth/doc/dg/concepts/about-docpage/).

<!-- source: ru/_includes/feedback-button-2.md -->
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

<a href="../../troubleshooting/feedback-new">
  <span class="button">Написать в службу поддержки</span>
</a>

<a href="../../troubleshooting/feedback-docs">
  <span class="button">Предложить улучшение для документации</span>
</a>
<!-- endsource: ru/_includes/feedback-button-2.md -->