Lesson 3. API access: how to submit a request
In this lesson, we are going to discuss the second step of enabling your app with access to Yandex Direct API: submitting a request.
Having registered your app with Yandex OAuth, you should submit a request for access to Yandex Direct API. An approved request is mandatory to perform API requests. Having received your request, we will add your app to the Yandex Direct compatible app registry to contact you as its developer: e.g., to notify you of important news or adjustments in your app operation.
There are two types of Yandex Direct API access:
- Trial access is a limited to Yandex Direct API; it allows you to run your app in the test environment (Sandbox) isolated from the real user data
- Full - full access to the Yandex Direct API; it allows your app to run both within the test environment and manage real ad campaigns.
Since you are learning to work with Yandex Direct API, request trial access for your app for now. You can make a request even if you haven't created your app yet. You can convert this request to a full access request at anytime later.
Alert
- Only the developer can submit a request for app access (as well as register the app with Yandex OAuth).
- Your app users don't need to do this.
- Please create a single request per each of your apps registered on Yandex OAuth: one app ID — one request for access. Once the request is approved, any number of users can run the app.
How to submit a request for access
-
Go to Yandex Direct API. If the page is unavailable, set up an account in Yandex Direct.
-
Click Get API access.
-
Accept the user agreement.
-
Go to the My requests tab.
-
Click the New request button. In the menu that opens, select the "Trial access" request type.
-
On the request creation form:
-
Select the app ID you have obtained while registering with Yandex OAuth in the previous lesson, from the list.
-
Enter an email address you currently use. We will use it to contact you when necessary.
-
Enter your app details in the other fields.
-
Confirm your compliance with the developer's user agreement.
-
Click the Send button.
-
How to find out the result of your request review
You can view your requests in the Yandex Direct web interface: go to the API section, My requests tab. On the tab you can:
- track the status of your request review; if it is declined, you can see the reasons here
- add, edit, and delete requests.
Request review timeframes
Access requests are reviewed from 10 a.m. to 7 p.m. on business days (excluding holidays in Russia). Request review can take from one hour up to three business days (during peak periods, it can take up to seven days).
What's next
So, you have created a request for access to Yandex Direct API. In the next lesson, you will learn how to get an OAuth token and then create and configure Sandbox. You can continue with this tutorial without having to wait until your request review is complete: you will need your approved request only later, when you proceed to making API requests.