--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.ru/dev/direct/doc/en/concepts/compare.md - https://yandex.ru/dev/direct/doc/ru/concepts/compare.md - href: ru/concepts/compare.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/migration/concepts/compare.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # Что изменилось в версии 5 ## Адреса {#url} В версии 5 нет единых адресов для всех запросов. API версии 5 состоит из отдельных сервисов, и каждый сервис имеет собственные адреса. Сервисы предназначены для работы с определенными классами объектов. Например, сервис `Campaigns` предназначен для управления кампаниями и имеет следующие адреса: - для JSON-запросов: ```httpget translate=no https://api.direct.yandex.com/json/v501/campaigns ``` - для SOAP-запросов: ```httpget translate=no https://api.direct.yandex.com/v501/campaigns ``` - WSDL-описание: ```httpget translate=no https://api.direct.yandex.com/v501/campaigns?wsdl ``` Адреса и список методов для каждого сервиса приведены в справочнике API. ### Узнайте больше - [Список сервисов API версии 5](https://yandex.ru/dev/direct/doc/ref-v5/concepts/about.html) ## Заявка на доступ к API {#request} Для доступа к API версии 5 разработчику необходимо [подать заявку](https://yandex.ru/dev/direct/doc/dg/concepts/register.html) и дождаться ее одобрения. Это обязательно для всех приложений, в том числе для тех, которые подключились к API до введения процедуры регистрации приложений и продолжали работу с версией 4 и Live 4 без подачи заявки. ## Авторизация {#token} Как и в старых версиях API, в запросе к API версии 5 необходимо указать OAuth-токен, разрешающий доступ к данным конкретного пользователя. Отличие состоит в том, что токен следует передавать не в теле запроса, а в HTTP-заголовке `Authorization`. Например: ```httpget translate=no Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f ``` {% note alert %} `Bearer` — служебная константа протокола OAuth. Ее указание обязательно. {% endnote %} ### Узнайте больше - [Доступ и авторизация](https://yandex.ru/dev/direct/doc/dg/concepts/access.html) - [HTTP-заголовки](https://yandex.ru/dev/direct/doc/dg/concepts/headers.html) ## Работа с клиентами агентств {#subclients} В версии 5 агентство может в одном запросе оперировать данными только одного пользователя — клиента агентства. Логин пользователя следует передавать в HTTP-заголовке `Client-Login`. Например: ```httpget translate=no Client-Login: agrom ``` Таким образом, если требуется получить или изменить данные нескольких пользователей, то необходимо выполнить отдельный запрос для каждого пользователя. ### Узнайте больше - [HTTP-заголовки](https://yandex.ru/dev/direct/doc/dg/concepts/headers.html) ## Структура объектов {#struct} Визитки, быстрые ссылки, уточнения и ключевые фразы в API версии 5 стали самостоятельными объектами, и для работы с ними предусмотрены отдельные сервисы. Управлять данными стало проще — например, чтобы изменить телефон в визитке, нет необходимости редактировать все объявления, в которых она используется. Также в API версии 5 реализована полная поддержка групп объявлений. ### Узнайте больше - [Объекты в API версии 5](https://yandex.ru/dev/direct/doc/dg/objects/objects.html) - [Соответствие методов](methods.html) ## Принципы работы с данными {#partial-edit} В версии 5 полностью изменилась логика работы с объектами: создания, редактирования, получения и др. Так, в запросе на создание или изменение нескольких объектов каждый объект обрабатывается отдельно. Например, если приложение отправило запрос на создание 100 объявлений и в одном из них некорректные значения параметров, то остальные 99 объявлений будут успешно созданы. В отличие от старых версий, для редактирования объекта больше не нужно передавать все его параметры. Достаточно указать только те параметры, значения которых требуется изменить. Остальные параметры изменены не будут. При этом сервер Директа все равно проверит объект целиком и, если с новыми значениями объект некорректен, вернет ошибку. Похожее правило действует и при получении данных — сервер возвращает не все параметры объекта, а только запрошенные приложением. Запрашивая только нужные параметры, можно существенно ускорить обмен данными. ## Валюта {#currency} В версии 5 все методы принимают и возвращают денежные значения в валюте пользователя. Параметр `Currency`, введенный в версии Live 4 для обеспечения обратной совместимости, не используется. {% note alert %} Все денежные значения (ставки, параметры стратегий и др.) передаются через API в виде целых чисел: сумма в валюте, умноженная на 1 000 000. Например, вместо ставки 2,5 руб. передается число 2 500 000. {% endnote %} ## Технические ограничения {#limits} В API версии 4 и Live 4 допускалось не более 5 одновременных запросов от имени одного **пользователя**. В API версии 5 допускается не более 5 одновременных запросов от имени одного **рекламодателя**. Не имеет значения, какой из представителей рекламодателя или агентства, обслуживающего рекламодателя, выполняет запрос. Ограничения на количество вызовов отдельных методов в API версии 5 не применяются. ## Баллы {#units} Система баллов в версии 5 в целом аналогична версии 4 и Live 4, однако имеется ряд отличий: - баллы начисляются не раз в сутки, а равномерно в течение суток; - баллы списываются не только за успешные вызовы, но и за ошибки; - агентство может расходовать собственные баллы на операции с данными рекламодателя — клиента агентства; - доступный остаток баллов возвращается в ответе на каждый запрос — не нужно вызывать отдельный метод для проверки остатка. ### Узнайте больше - [Баллы в версии 5](https://yandex.ru/dev/direct/doc/dg/concepts/units.html) ## Идентификатор запроса {#request-id} API версии 5 присваивает каждому запросу уникальный идентификатор и возвращает его в ответе на запрос. Пожалуйста, указывайте этот идентификатор при обращении в [службу поддержки](https://yandex.ru/dev/direct/doc/support/troubleshooting/issue.html). ### Узнайте больше - [HTTP-заголовки](https://yandex.ru/dev/direct/doc/dg/concepts/headers.html)