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

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

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

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

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

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

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

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

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

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

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

name: имя.
id_card: номер удостоверения личности.
image_url: ссылка на изображение лица, которое нужно обработать.
validity_end: дата окончания срока действия удостоверения, формат: YYYYMMDD, для долгосрочного использования укажите “00000000”;
validity_begin: дата начала срока действия удостоверения, формат: YYYYMMDD.
encryption: необязательный параметр для шифрования чувствительных данных (если необходимо отправить зашифрованные данные).

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

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

{
  "result": "0",
  "description": "一致"
}

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

result, код результата проверки, условия оплаты следующие.
- Платные коды результата:
  - 0: Имя и номер удостоверения личности совпадают
  - -1: Имя и номер удостоверения личности не совпадают
- Бесплатные коды результата:
  - -2: Неверный номер удостоверения личности (длина, контрольная цифра и т.д. некорректны)
  - -3: Неверное имя (длина, формат и т.д. некорректны)
  - -4: Ошибка сервиса базы данных удостоверений
  - -5: В базе данных удостоверений нет записи с этим номером
  - -6: Система авторитетного сопоставления обновляется, пожалуйста, попробуйте позже
  - -7: Превышено количество проверок за день.
description, результат проверки имени и номера удостоверения личности.

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

curl -X POST 'https://api.acedata.cloud/identity/idcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "id_card": "***",
  "validity_begin": "***",
  "validity_end": "***"
}'

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

import requests

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

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

payload = {
    "name": "***",
    "id_card": "***",
    "validity_begin": "***",
    "validity_end": "***"
}

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 проверки идентификационной информации и срока действия

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

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

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

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

Заключение

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

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

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

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

​Заключение

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

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

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

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

Заключение