---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/support2/ord/ru/api/connect.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support2/ord/ru/llms.txt

# Как подключиться к API ОРД Яндекса

## Шаг 1. Получите доступ в кабинет ОРД

Подробнее в разделе Справки [Как получить доступ в кабинет ОРД](https://yandex.ru/support2/ord/ru/access.md).

## Шаг 2. Откройте доступ к API

Доступ к API может открыть пользователь с ролью «Главный представитель» или «Администратор». 

#### **Выдать доступ себе** 

В левом меню перейдите в раздел **Настройки** → **Пользователи и роли**. В правом верхнем углу нажмите **Открыть доступ к API**.

<br>

![](../_assets/access-api.png){.border-yes}

<br>
<br>
<br>

#### **Выдать доступ другому пользователю** 

1. В левом меню перейдите в раздел **Настройки** → **Пользователи и роли**. 
2. Нажмите на имя пользователя в списке. Если пользователя нет в списке, в правом верхнем углу нажмите кнопку **Выдать доступ** и найдите его через поиск.
3. В открывшемся окне отметьте галочкой пункт **Доступ к API** и сохраните изменения. 

Один пользователь может иметь доступ к API только одного кабинета ОРД. Чтобы выдать доступ пользователю, у которого уже есть доступ к API другого кабинета ОРД, перейдите в другой кабинет и отзовите доступ. Для этого нажмите на его имя в списке. В открывшемся окне снимите галочку с пункта **Доступ к API** и сохраните изменения.

## Шаг 3. Получите токен

Для отправки запросов через API получите персональный токен. Он будет привязан к Яндекс ID пользователя, через который подтвержден доступ.

1. В левом меню перейдите в раздел **Настройки** → **Пользователи и роли** → **Получить токен для API**.

    ![](../_assets/token.png){.border-yes}

2. На странице авторизации Яндекс ID разрешите доступ для сервиса «API Яндекс.ОРД». Для этого нажмите кнопку **Войти как _<имя пользователя>_**. Проверьте, что вы находитесь именно под тем аккаунтом, на который выдан доступ к API. 

3. Сохраните токен для использования при авторизации в API.

## Спецификация

* [https://ord.yandex.net/api/docs](https://ord.yandex.net/api/docs) – продакшен;
* [https://ord-prestable.yandex.net/api/docs](https://ord-prestable.yandex.net/api/docs) – тестовый контур.



<!-- Полученный токен поможет авторизовывать запросы, которые отправляются через API. -->

<!-- ## 4. Добавьте информацию об организации -->

<!-- Сохраните информацию об организации с помощью метода [organization](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/organization_api_v4_organization_post). Этот же метод поможет отредактировать её. -->

<!-- ## 5. Добавьте информацию о договоре -->

<!-- Сохраните информацию о первом договоре в цепочке участников с помощью метода [contract](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/contract_api_v4_contract_post). При необходимости используйте этот метод, чтобы отредактировать информацию о договоре. -->

<!-- ## 6. Зарегистрируйте креатив -->

<!-- Создайте и зарегистрируйте новый креатив. Согласно ФЗ «О рекламе», всю онлайн-рекламу, которая показывается на территории России, нужно маркировать. -->

<!-- 1. Когда создадите новый креатив, зарегистрируйте его в ОРД с помощью метода API [creative](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/creative_api_v4_creative_post). -->
<!-- 1. Получите маркер рекламы — идентификатор или токен. Он появится в поле `token`, когда вы выполните запрос метода `status` с `request_id` из запроса на регистрацию креатива. -->
<!-- 1. Используйте маркер рекламы при показе рекламных объявлений. [Маркер (идентификатор) рекламы](https://interactivead.ru/wp-content/uploads/2022/11/arir22_rkn_03.11.pdf) — это уникальное цифровое обозначение, которое помогает отслеживать рекламу в интернете и учитывать информацию о ней. -->

<!-- ## 7. Зарегистрируйте акты -->

<!-- Зарегистрируйте ваши акты в ОРД в течение 30 дней месяца, следующего за тем, в котором произошёл первый показ креатива. Зарегистрировать акт в ОРД Яндекса нужно с помощью метода [invoice](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/invoice_api_v4_invoice_post). -->

<!-- ## 8. Передайте сведения о креативах -->

<!-- После регистрации акта с помощью помощи метода [invoice/creatives](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/invoice_creatives_api_v4_invoice_creatives_post) передайте сведения о креативах, показанных в рамках конкретных пунктов разаллокации акта по изначальным договорам. -->

<!-- ## 9. Передайте данные о показах -->

<!-- Передавайте данные о показах интернет-рекламы и их стоимости в ОРД ежемесячно — длительность договора рекламной кампании не имеет значения. Обратите внимание: в текущем месяце передаются данные за предыдущий. Статистика передаётся в ОРД Яндекса с помощью метода [statistics](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/statistics_api_v4_statistics_post) , перед отправкой данных по статистике необходимо при помощи метода [platforms](https://ord.yandex.net/api/docs#/API%20version%204%3A%20Загрузка%20объектов/platforms_api_v4_platforms_post) зарегистрировать набор площадок, на которых выполнялся показ рекламной кампании. -->