Getting an OAuth token

To work with the Track & Trace API, you need an OAuth token. OAuth token requirements:

• The token must be created for a user who's an administrator in the company.
• The token mustn't be revoked. For more information, see Token lifetime.

To start working with the Track & Trace API, get an OAuth token:

1. If necessary, create an account in Yandex ID. When registering, use a corporate or any other email address on Yandex Mail.
2. Log in to Yandex with the account you will use to upload data.
3. Open the Create app page in Oauth for Yandex ID.
4. In the General section, fill in the Service name field.

   You can enter any name. It will appear in your app list in OAuth for Yandex ID.

   You don't need to attach the service icon.

5. In the Platforms section:

   1. Select Web services.
   2. Place the cursor in the Redirect URI field that appears and paste the address https://oauth.yandex.com/verification_code or click Enter URL for debugging in the popup.

      
6. In the Data access section, enter courier:logistician and select Logistics Coordinator role - Load courier and order information, export results.

   
7. At the bottom of the page, click Create app.

   This opens the application page. You'll need the app ID from the ClientID field to get an OAuth token.

   
8. Get the OAuth token. To do this:

   1. Open the link. Enter the value obtained in step 7 in the <your-app-ClientID> field.

      https://oauth.yandex.com/authorize?response_type=token&client_id=<your-app-ClientID>

   2. Make sure the service prompts you to log in under the correct username.
   3. Click Log in as <username>.
   4. Copy the string that appears on the screen: this is your OAuth token.
   5. Make sure the token works. To do this, add it to the request header:

      curl -H "Authorization: Auth <your-OAuth-token>" -X GET https://courier.yandex.ru/api/v1/test
      Copied to clipboard

      The response should be: {"message":"OK"}.

   For more information about OAuth, see OAuth implementation in Yandex.