Creating and using an API Key token

To work with Yandex.Market via the API:

  1. Create a token with access to certain groups of methods. This way, employees will be able to perform only those methods that they need for their work. What types of access are available
  2. Insert the token into the headers of Market requests.

Only the cabinet owner and cabinet manager can create and manage tokens. For more information about what roles are available, read in the Help of the Market for sellers.

Create a token

  1. In the cabinet in the lower left corner, click on the name of your business and go to the page Modules and APIs.

  2. In the block Authorization token Click the button To create or Create a new token if you have already received it.

    Screenshot

  3. In the window that opens:

    1. Specify the unique name of the token.

    2. Select one or more access points for this token.

    3. Click the button To create.

    Screenshot

Edit the token

Before editing

Make sure that your integration will continue to work with the modified token.

You can change access rights, as well as the name of the token. To do this:

  1. In the cabinet in the lower left corner, click on the name of your business and go to the page Modules and APIs.

  2. In the block Authorization tokens find the one you need, tap the three dots next to it and select Edit.

  3. Change the required information.

  4. Click Save.

The information will be updated within 10 minutes.

Delete a token

Before deleting

Make sure that your integration will continue to work without this token.

  1. In the cabinet in the lower left corner, click on the name of your business and go to the page Modules and APIs.

  2. In the block Authorization tokens find the one you need, tap the three dots next to it and select Remove.

  3. Confirm the deletion.

Transfer the token

Insert the received token into the header Api-Key according to the following scheme:

Api-Key: <token>

As a result, the title will look like this:

Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664

If the request is received without a header with a valid token, the Market returns an error. 401 Unauthorized.

It may be useful