Инструкция по интеграции API проверки фотографий на удостоверении личности

В этой статье будет представлена инструкция по интеграции API проверки фотографий на удостоверении личности, который может использоваться для передачи фотографий лицевой стороны удостоверения личности, распознавания информации на фотографии удостоверения и сопоставления имени, номера удостоверения и фотографии удостоверения с фотографиями из авторитетной базы данных, чтобы определить, принадлежит ли это удостоверение личности одному и тому же человеку, тем самым проверяя подлинность информации удостоверения личности.

Процесс подачи заявки

Чтобы использовать API проверки фотографий на удостоверении личности, сначала перейдите в консоль Ace Data Cloud, чтобы получить ваш API Token и сохранить его для дальнейшего использования.

Если вы еще не вошли в систему или не зарегистрированы, вас автоматически перенаправит на страницу входа, где вас пригласят зарегистрироваться и войти. После завершения вы будете автоматически возвращены на текущую страницу. Один API Token позволяет использовать все услуги платформы, не нужно отдельно запрашивать для каждой услуги. При первом запросе предоставляется бесплатный лимит, чтобы вы могли попробовать; если лимит исчерпан, вы можете пополнить общий баланс в консоли.

📘 Полная документация: API проверки фотографий на удостоверении личности →

Основное использование

Сначала ознакомьтесь с основным способом использования, который заключается в том, что вы вводите ссылку на изображение удостоверения личности, и получаете обработанный результат проверки. Сначала необходимо просто передать поле image_url, после чего мы можем заполнить соответствующие данные на интерфейсе, как показано на рисунке:

Как видно, мы настроили заголовки запроса, включая:

accept: формат ответа, который вы хотите получить, здесь указано application/json, то есть формат JSON.
authorization: ключ для вызова API, после запроса вы можете выбрать его из выпадающего списка.

Также настроено тело запроса, включая:

image_url: ссылка на изображение удостоверения личности, которое нужно обработать.
config: необязательный параметр конфигурации, булевое поле, по умолчанию все значения false, поддерживает copy_warn, border_check_warn, reshoot_warn, detect_ps_warn, temp_id_warn, quality (порог 0-100).

После выбора вы можете заметить, что справа также сгенерирован соответствующий код, как показано на рисунке:

Нажмите кнопку «Попробовать», чтобы провести тестирование, как показано на рисунке, и мы получим следующий результат:

{
  "sim": 99.76,
  "result": "Success",
  "description": "成功",
  "name": "身份证姓名",
  "sex": "身份证性别",
  "nation": "身份证民族",
  "birth": "身份证生日",
  "address": "身份证家庭住址",
  "id_num": "身份证号码",
  "portrait": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBA.....DEhE2lbPMcOtG3f/DLT/yX8if7Kxn/AD7h85wdttPifRf1e6//2Q==",
  "warnings": "",
  "quality": 0,
  "encryption": null
}

Возвращаемый результат содержит несколько полей, описание которых приведено ниже:

sim: степень сходства, диапазон значений [0.00, 100.00]. Рекомендуется считать, что степень сходства 70 и выше указывает на то, что это один и тот же человек, порог можно настроить в зависимости от конкретной ситуации (порог 70 имеет вероятность ложного срабатывания 0.1%, порог 80 - 0.01%).
result: код ошибки бизнеса, в случае успеха возвращает Success, в случае ошибки смотрите раздел с кодами ошибок ниже в части FailedOperation.
description: результат проверки имени и номера удостоверения.
name: информация о имени из удостоверения, если изображение удостоверения не загружено, то поле пустое.
sex: информация о поле из удостоверения, если изображение удостоверения не загружено, то поле пустое.
nation: информация о национальности из удостоверения, если изображение удостоверения не загружено, то поле пустое.
birth: информация о дате рождения из удостоверения, если изображение удостоверения не загружено, то поле пустое.
address: информация о домашнем адресе из удостоверения, если изображение удостоверения не загружено, то поле пустое.
id_num: информация о номере удостоверения из удостоверения, если изображение удостоверения не загружено, то поле пустое.
portrait: base64 кодировка фотографии удостоверения, если вырезка не удалась, будет использовано целое удостоверение для сравнения и возвращено пустое значение.
warnings: информация о предупреждениях, если в конфигурации настроены предупреждения, сравнение изображений будет остановлено, результат вернет ошибку (FailedOperation.OcrWarningOccurred) и будет содержать эту информацию о предупреждении.
quality: оценка качества изображения, этот параметр имеет значение только если в конфигурации запроса настроено предупреждение о размытости изображения, диапазон значений (0-100), в настоящее время порог по умолчанию составляет 50, значение ниже 50 вызовет предупреждение о размытости.
encryption: информация о шифровании конфиденциальных данных.

Можно увидеть, что информация удостоверения имеет высокую степень подлинности. Кроме того, если вы хотите сгенерировать соответствующий код интеграции, вы можете просто скопировать его, например, код CURL выглядит следующим образом:

curl -X POST 'https://api.acedata.cloud/identity/idcard/check-1e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": {image_url}
}'

Код интеграции на Python выглядит следующим образом:

import requests

url = "https://api.acedata.cloud/identity/idcard/check-1e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": {image_url}
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Обработка ошибок

При вызове API, если возникает ошибка, API вернет соответствующий код ошибки и информацию. Например:

400 token_mismatched: Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
400 api_not_implemented: Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
401 invalid_token: Неавторизовано, недействительный или отсутствующий токен авторизации.
429 too_many_requests: Слишком много запросов, вы превысили лимит частоты.
500 api_error: Внутренняя ошибка сервера, что-то пошло не так на сервере.

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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Заключение

С помощью этого документа вы узнали, как использовать API проверки фотографий на удостоверении личности для передачи фотографий лицевой стороны удостоверения, распознавания информации на фотографии удостоверения и сопоставления имени, номера удостоверения и фотографии удостоверения с фотографиями из авторитетной базы данных, чтобы определить, принадлежит ли это удостоверение личности одному и тому же человеку, тем самым проверяя подлинность информации удостоверения личности. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Прокси

Продвинутый

Coding

Инструкция по интеграции API проверки фотографий на удостоверении личности

Процесс подачи заявки

Основное использование

Обработка ошибок

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

Заключение

​Процесс подачи заявки

​Основное использование

​Обработка ошибок

​Пример ответа об ошибке

​Заключение

Процесс подачи заявки

Основное использование

Обработка ошибок

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

Заключение