API: распознавание паспортов Армении

Извлекает сведения из паспорта Армении.

Как вызвать

Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

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

curl -sS \
  -X POST "https://docs.dadata.ru/api/v1/extract/passport_am" \
  -H "Authorization: Token ${API_KEY}" \
  -H "X-Secret: ${SECRET_KEY}" \
  -F "file=@armenia-passport.jpg;type=image/jpeg"

import requests

url = "https://docs.dadata.ru/api/v1/extract/passport_am"

headers = {
    "Authorization": "Token ${API_KEY}",
    "X-Secret": "${SECRET_KEY}",
}

with open("armenia-passport.jpg", "rb") as f:
    response = requests.post(
        url,
        files={
            "file": ("armenia-passport.jpg", f, "image/jpeg"),
        },
        headers=headers,
        timeout=600,
    )

response.raise_for_status()
data = response.json()

print("result:", data["data"])
print("metadata:", data["metadata"])

Укажите при вызове:

• ${API_KEY} — API-ключ.
• ${SECRET_KEY} — секретный ключ.

Тело запроса передавайте в кодировке UTF-8.

Запрос отправляйте в формате multipart/form-data.

Параметры запроса

Что в ответе

{
  "data": {
    "number": "JJ0006381",
    "surname_en": "KARAPOTYAN",
    "given_names_en": "KARAPOT",
    "gender": "F",
    "birthdate": "12.05.1961",
    "birthplace": "ARMENIA",
    "issue_date": "16.07.2012",
    "expiry_date": "16.07.2017"
  },
  "metadata": {
    "number": {
      "confidence": 0.6181363224241413
    },
    "surname_en": {
      "confidence": 0.9148840977384021
    },
    "given_names_en": {
      "confidence": 0.9626595924798091
    },
    "gender": {
      "confidence": 0.9999982118638471
    },
    "birthdate": {
      "confidence": 0.998998097052204
    },
    "birthplace": {
      "confidence": 0.9566294400034411
    },
    "issue_date": {
      "confidence": 0.9998848570841458
    },
    "expiry_date": {
      "confidence": 0.9998635239903881
    }
  }
}

API возвращает объект с результатами извлечения. Он состоит из двух объектов:

• объект data содержит найденные значения.
• объект metadata содержит метаданные извлечения для каждого поля. Поле confidence представляет оценку уверенности распознавания в диапазоне от 0 до 1.

Коды ответа на запрос

Ограничения

Максимальная частота запросов — 10 в минуту с одного IP-адреса. Напишите на info@dadata.ru, если этого мало.

Файл в запросе — PDF, JPG, PNG до 20 МБ.

Стоимость

3 ₽ за страницу. Не входит в годовую подписку.