Getting information about the authorization token

The method is available for all models.

If you are using an API Key token, one of the accesses in the list is required to call the method

The method is only available for the Api Key token.

Returns information about the transmitted authorization token.

, Limit: 100 requests per hour

Request

POST

https://api.partner.market.yandex.ru/auth/token

Responses

200 OK

Information about the authorization token.

Body

application/json
{
    "status": "OK",
    "result": {
        "apiKey": {
            "name": "string",
            "authScopes": [
                "ALL_METHODS"
            ]
        }
    }
}

Name

Description

result*

Type: TokenDTO

Information about the authorization token.

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

TokenDTO

Information about the authorization token.

Name

Description

apiKey*

Type: ApiKeyDTO

Information about the Api Key token.

ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

ApiKeyDTO

Information about the Api Key token.

Name

Description

authScopes*

Type: ApiKeyScopeType[]

Access to methods using the Api Key token.
Access to methods:

  • ALL_METHODS — full cabinet management.
  • ALL_METHODS_READ_ONLY — view all information in the cabinet.
  • INVENTORY_AND_ORDER_PROCESSING — order processing and accounting of goods.
  • INVENTORY_AND_ORDER_PROCESSING_READ_ONLY — view information about orders.
  • PRICING — price management.
  • PRICING_READ_ONLY — view prices.
  • OFFERS_AND_CARDS_MANAGEMENT — management of goods and cards.
  • OFFERS_AND_CARDS_MANAGEMENT_READ_ONLY — view products and cards.
  • PROMOTION — product promotion.
  • PROMOTION_READ_ONLY — view information about product promotions.
  • FINANCE_AND_ACCOUNTING — View financial information and statements.
  • COMMUNICATION — communication with customers.
  • SETTINGS_MANAGEMENT — setting up stores.
  • SUPPLIES_MANAGEMENT_READ_ONLY — receiving information on FBY applications.

Enum: ALL_METHODS, ALL_METHODS_READ_ONLY, INVENTORY_AND_ORDER_PROCESSING, INVENTORY_AND_ORDER_PROCESSING_READ_ONLY, PRICING, PRICING_READ_ONLY, OFFERS_AND_CARDS_MANAGEMENT, OFFERS_AND_CARDS_MANAGEMENT_READ_ONLY, PROMOTION, PROMOTION_READ_ONLY, FINANCE_AND_ACCOUNTING, COMMUNICATION, SETTINGS_MANAGEMENT, SUPPLIES_MANAGEMENT_READ_ONLY

Unique items  

name*

Type: string

The name of the token.

Min length: 1

Max length: 100

ApiKeyScopeType

Access to methods:

  • ALL_METHODS — full cabinet management.
  • ALL_METHODS_READ_ONLY — view all information in the cabinet.
  • INVENTORY_AND_ORDER_PROCESSING — order processing and accounting of goods.
  • INVENTORY_AND_ORDER_PROCESSING_READ_ONLY — view information about orders.
  • PRICING — price management.
  • PRICING_READ_ONLY — view prices.
  • OFFERS_AND_CARDS_MANAGEMENT — management of goods and cards.
  • OFFERS_AND_CARDS_MANAGEMENT_READ_ONLY — view products and cards.
  • PROMOTION — product promotion.
  • PROMOTION_READ_ONLY — view information about product promotions.
  • FINANCE_AND_ACCOUNTING — View financial information and statements.
  • COMMUNICATION — communication with customers.
  • SETTINGS_MANAGEMENT — setting up stores.
  • SUPPLIES_MANAGEMENT_READ_ONLY — receiving information on FBY applications.

Type

Description

ApiKeyScopeType

Enum: ALL_METHODS, ALL_METHODS_READ_ONLY, INVENTORY_AND_ORDER_PROCESSING, INVENTORY_AND_ORDER_PROCESSING_READ_ONLY, PRICING, PRICING_READ_ONLY, OFFERS_AND_CARDS_MANAGEMENT, OFFERS_AND_CARDS_MANAGEMENT_READ_ONLY, PROMOTION, PROMOTION_READ_ONLY, FINANCE_AND_ACCOUNTING, COMMUNICATION, SETTINGS_MANAGEMENT, SUPPLIES_MANAGEMENT_READ_ONLY

400 Bad Request

The request contains incorrect data. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

ApiErrorDTO

The general error format.

Name

Description

code*

Type: string

The error code.

message

Type: string

Description of the error.

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

500 Internal Server Error

Internal error in Yandex. Market. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.