Hoppa till huvudinnehåll
Denna artikel kommer att introducera en ID-korts bildverifiering API integration, som kan användas för att skicka in en bild av ID-kortets ansikte, identifiera informationen på ID-kortsbilden och jämföra namn, ID-nummer och ID-kortsbild med auktoritativa databaser för att avgöra om det är samma person, och därmed verifiera äktheten av ID-kortsinformationen.

​
Ansökningsprocess

För att använda API:et måste du först gå till ID-korts bildverifiering API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på “Acquire”-knappen, som visas i bilden nedan: Om du inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in. Efter att ha loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som kan användas för att gratis använda detta API.

​
Grundläggande användning

Först bör du förstå den grundläggande användningsmetoden, vilket är att ange en länk till ID-kortsbilden för att få verifieringsresultatet efter bearbetning. Du behöver först enkelt skicka ett image_url fält, och vi kan sedan fylla i motsvarande innehåll på gränssnittet, som visas i bilden nedan:

Här kan vi se att vi har ställt in Request Headers, inklusive:
  • accept: vilken format av svar du vill ta emot, här anges application/json, det vill säga JSON-format.
  • authorization: API-nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.
Dessutom har vi ställt in Request Body, inklusive:
  • image_url: länken till ID-kortsbilden som ska bearbetas.
  • 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).
När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden nedan:

Klicka på “Try”-knappen för att utföra ett test, som visas i bilden ovan, här får vi följande resultat: 
{
  "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
}
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • 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, kan justeras baserat 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 i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • sex, könsinformationen i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • nation, nationalitetsinformationen i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • birth, födelsedagsinformationen i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • address, hemadressen i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • id_num, ID-nummerinformationen i 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 har denna parameter betydelse, 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.
Det kan ses att ID-kortsinformationen har en mycket hög äkthet. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genereras, till exempel CURL-koden nedan: 
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 integrationskoden ser ut så här: 
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

När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 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: Unauthorized, 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": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder ID-korts bildverifiering API för att skicka in en bild av ID-kortets ansikte, identifiera informationen på ID-kortsbilden och jämföra namn, ID-nummer och ID-kortsbild med auktoritativa databaser för att avgöra om det är samma person, och därmed verifiera äktheten av ID-kortsinformationen. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.