ID-korts bildverifiering API integration

​

Ansökningsprocess

📘 Fullständig dokumentation: ID-korts bildverifiering API →

​

Grundläggande användning

• accept: vilken format av svar du vill ta emot, här anges application/json, vilket innebär JSON-format.
• authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.

• image_url: länken till ID-kortsbilden som ska behandlas.
• config: valfria konfigurationsalternativ, booleska fält, som standard är alla false, stöder copy_warn, border_check_warn, reshoot_warn, detect_ps_warn, temp_id_warn, quality (tröskelvärde 0-100).

{
  "sim": 99.76,
  "result": "Success",
  "description": "Framgång",
  "name": "ID-korts namn",
  "sex": "ID-korts kön",
  "nation": "ID-korts nationalitet",
  "birth": "ID-korts födelsedatum",
  "address": "ID-korts hemadress",
  "id_num": "ID-korts nummer",
  "portrait": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBA.....DEhE2lbPMcOtG3f/DLT/yX8if7Kxn/AD7h85wdttPifRf1e6//2Q==",
  "warnings": "",
  "quality": 0,
  "encryption": null
}

• sim, likhet, värdeintervallet [0.00, 100.00]. Rekommenderad likhet är större än eller lika med 70 för att bedömas som samma person, tröskelvärdet kan justeras beroende på specifika scenarier (tröskelvärde 70 har en falsk godkännandegrad på en av tusen, tröskelvärde 80 har en falsk godkännandegrad på en av tiotusen).
• result, affärsfelkod, framgångsrik situation returnerar Success, för felaktiga situationer, se felkodslistan nedan i FailedOperation-delen.
• description, här är resultatet av verifieringen av namn och ID-nummer.
• name, namninformationen på ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
• sex, könsinformationen på ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
• nation, nationalitetsinformationen på ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
• birth, födelsedatumet på ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
• address, hemadressen på ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
• id_num, ID-nummerinformationen på ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
• portrait, base64-kodningen av ID-kortsbilden, om bildbehandlingen misslyckas kommer hela ID-kortet att användas för jämförelse och returnera tomt.
• warnings, varningsinformation, när varningsinformation konfigureras i Config kommer ansiktsjämförelsen att stoppas, Resultatet returnerar ett fel (FailedOperation.OcrWarningOccurred) och har denna varningsinformation.
• quality, bildkvalitetspoäng, när bildosäkerhetsvarning konfigureras i begäran är detta parameter meningsfullt, värdeintervallet (0～100), för närvarande är standardtröskelvärdet 50 poäng, under 50 poäng utlöser osäkerhetsvarning.
• encryption, känslig data krypteringsinformation.

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}
}'

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)

​

Felhantering

• 400 token_mismatched: Bad request, kan bero på saknade eller ogiltiga parametrar.
• 400 api_not_implemented: Bad request, kan bero på saknade eller ogiltiga parametrar.
• 401 invalid_token: Obehörig, ogiltig eller saknad auktoriseringstoken.
• 429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
• 500 api_error: Intern serverfel, något gick fel på servern.

​

Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Slutsats