Adocs

Отправляет изображение паспорта на распознавание. Списание средств происходит автоматически.

Заголовки

Заголовок	Обязательный	Описание
X-Api-Key	Да	Ваш API-ключ
Idempotency-Key	Нет	Уникальный ключ запроса (UUID). При повторной отправке в течение 24ч вернётся тот же результат без повторного списания.
Content-Type	Да	multipart/form-data

Тело запроса

Content-Type: multipart/form-data

file: <binary image data>  (JPEG, PNG, WebP, макс. 10 МБ)

Пример запроса (cURL)

curl -X POST https://api.adocs.ru/v1/recognize \
  -H "X-Api-Key: ВАШ_API_КЛЮЧ" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@passport.jpg"

Успешный ответ (200 OK)

{
  "request_id": "req_1751234567890123456",
  "last_name": "Иванов",
  "first_name": "Иван",
  "middle_name": "Иванович",
  "birth_date": "15.03.1990",
  "series": "4515",
  "number": "123456",
  "issue_date": "20.05.2015",
  "issued_by": "ОТДЕЛОМ УФМС РОССИИ ПО Г. МОСКВЕ ПО РАЙОНУ ...",
  "division_code": "770-064",
  "registration_address": null
}

Описание полей ответа

Поле	Тип	Описание
request_id	string	Уникальный ID запроса
last_name	string	Фамилия
first_name	string	Имя
middle_name	string	Отчество
birth_date	string	Дата рождения (ДД.ММ.ГГГГ)
series	string	Серия паспорта (4 цифры)
number	string	Номер паспорта (6 цифр)
issue_date	string	Дата выдачи (ДД.ММ.ГГГГ)
issued_by	string	Кем выдан
division_code	string	Код подразделения (XXX-XXX)
registration_address	string|null	Адрес регистрации (если распознан)

Ошибки

Код	Описание
401 Unauthorized	Отсутствует или невалидный X-Api-Key
402 Payment Required	Недостаточно средств на балансе
413 Payload Too Large	Файл больше 10 МБ
415 Unsupported Media Type	Неподдерживаемый формат файла (допустимы JPEG, PNG, WebP)
429 Too Many Requests	Превышен лимит 10 RPS на ключ

Возвращает текущий баланс и активную подписку.

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

curl -X GET https://api.adocs.ru/v1/me \
  -H "X-Api-Key: ВАШ_API_КЛЮЧ"

Ответ

{
  "balance": {
    "account_id": 42,
    "real_balance_rub": 1500.00,
    "prepaid_balance_rub": 6000.00
  },
  "subscription": {
    "subscription_id": 7,
    "tariff_code": "pro",
    "tariff_name": "Pro",
    "status": "active",
    "expires_at": "2026-06-01T00:00:00Z"
  }
}

Ошибки

Код	Описание
401 Unauthorized	Отсутствует или невалидный X-Api-Key

История операций (пополнения, списания, подписки).

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

curl -X GET https://api.adocs.ru/v1/events \
  -H "X-Api-Key: ВАШ_API_КЛЮЧ"

Ответ

[{
  "id": 101,
  "type": "pay_as_you_go",
  "real_amount_rub": 7.00,
  "prepaid_amount_rub": 0,
  "created_at": "2026-05-20T14:32:00Z"
}]

Ошибки

Код	Описание
401 Unauthorized	Отсутствует или невалидный X-Api-Key