Урок 8. Как работать c реальными данными
Что делать, если заявка одобрена, но доступ не появился
Если в ответ на запрос к API вы получаете ошибку, проверьте, на какой адрес приложение отправляет запрос: возможно, указана не та версия API или не тот сервис. Убедитесь, что токен был получен для именно для того пользователя Директа, к чьим данным обращается приложение.
Адреса для запросов
- Для JSON-запросов —
https://api.direct.yandex.com/json/v501/{сервис} - Для SOAP-запросов —
https://api.direct.yandex.com/v501/{сервис} - WSDL-описание находится по адресу
https://api.direct.yandex.com/v501/{сервис}?wsdl
Здесь {сервис} — имя сервиса, с которым вы хотите работать.
В настоящее время доступны некоторые методы предыдущих версий API Директа. Адреса предыдущих версий отличаются от адресов версии 5.
OAuth-токены для пользователей приложения
С точки зрения пользователя процедура получения токена должна выглядеть так:
- Приложение открывает для пользователя специальную страницу сервиса Яндекс OAuth — страницу запроса доступа.
- Пользователю необходимо войти на Яндекс под своим логином в Директе (если он еще не сделал этого).
- На странице запроса доступа пользователь нажимает кнопку Разрешить.
- В зависимости от настроек приложения, Яндекс OAuth перенаправляет пользователя на адрес, указанный в параметре Callback URL, или возвращает пользователя в приложение.
Яндекс OAuth генерирует токен и передает его приложению в автоматическом режиме. В Яндекс OAuth предусмотрено несколько способов передачи токена, которые подходят для разных типов приложений: веб-сервис, настольное приложение (программа для компьютера), мобильное приложение и др. Все способы подробно описаны в документации Яндекс OAuth.
Что дальше
Теперь вы знаете, как управлять реальными рекламно-информационными материалами, используя API Директа. В следующем уроке мы расскажем о системе ограничений, применяемой в API, и приведем рекомендуемый сценарий работы приложения.