Получить водительские удостоверения

Необходимо согласие пользователя на получение информации о водительских удостоверениях. В поле scope у токена должен присутствовать доступ вида opensme/individual/driver-licenses/get

AUTHORIZATIONS: httpAuth

Responses

200 Водительские удостоверения400401403422429500

200 Водительские удостоверения

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`licenses`	array of objects	Водительские удостоверения физического лица
`docNumber`	string	Номер документа водительского удостоверения
`issueDate`	string	Дата выдачи водительского удостоверения

Пример запроса

GET https://business.tinkoff.ru/openapi/api/v1/individual/documents/driver-licenses

Пример ответа

{
  "licenses": [
    {
      "docNumber": "1122334455",
      "issueDate": "2020-10-01"
    }
  ]
}

400 Некорректный запрос

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`errorId` (required)	string	Уникальный идентификатор ошибки
`errorMessage` (required)	string	Текст ошибки
`errorCode` (required)	string	Код ошибки
`errorDetails` (required)	object	Дополнительные данные об ошибке

401 Ошибка аутентификации

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`errorId` (required)	string	Уникальный идентификатор ошибки
`errorMessage` (required)	string	Текст ошибки
`errorCode` (required)	string	Код ошибки

Примеры ответа ошибкии 401:

{
  "errorId": "asdq3412",
  "errorMessage": "Не хватает учетных данных",
  "errorCode": "UNAUTHORIZED"
}

403 Ошибка авторизации

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`errorId` (required)	string	Уникальный идентификатор ошибки
`errorMessage` (required)	string	Текст ошибки
`errorCode` (required)	string	Код ошибки

Примеры ответа ошибкии 403:

{
  "errorId": "rtbe4567",
  "errorMessage": "Неправильный Tls сертификат",
  "errorCode": "FORBIDDEN"
}

422 Ошибка при обработке данных

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`errorId` (required)	string	Уникальный идентификатор ошибки
`errorMessage` (required)	string	Текст ошибки
`errorCode` (required)	string	Код ошибки
`errorDetails` (required)	object	Дополнительные данные об ошибке

429 Слишком много запросов

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`errorId` (required)	string	Уникальный идентификатор ошибки
`errorMessage` (required)	string	Текст ошибки
`errorCode` (required)	string	Код ошибки

Примеры ответа ошибкии 429:

{
"errorMessage": "Слишком много запросов. Попробуйте позже",
"errorCode": "TOO_MANY_REQUESTS",
"errorId": "acdf000"
}

500 Ошибка сервера

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters	Type	Description
`errorId` (required)	string	Уникальный идентификатор ошибки
`errorMessage` (required)	string	Текст ошибки
`errorCode` (required)	string	Код ошибки

Примеры ответа ошибкии 500:

{
  "errorId": "asdq3412",
  "errorMessage": "Непредвиденная ошибка. Пожалуйста, попробуйте позже",
  "errorCode": "INTERNAL_ERROR"
}