Hoppa till huvudinnehåll
Denna artikel kommer att introducera en ID-kortsigenkänning och informationsverifiering API-integration, som kan verifiera äktheten och överensstämmelsen av namn och ID-nummer genom att ange en bild av ID-kortet eller namn och ID-nummer. Detta gränssnitt används för att verifiera äktheten och överensstämmelsen av namn och ID-nummer, och du kan ange namn och ID-nummer eller skicka en bild av ID-kortets framsida för att tillhandahålla den nödvändiga verifieringsinformationen.

​
Ansökningsprocess

För att använda API:et måste du först gå till ID-kortsigenkänning och informationsverifiering API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på knappen “Acquire”, 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 ges, så att du kan använda API:et gratis.

​
Grundläggande användning

Först och främst, låt oss förstå den grundläggande användningsmetoden, vilket är att ange en länk till ID-kortsbilden för att få verifieringsresultatet efter bearbetning. Först behöver vi 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 typ av svar vi vill ta emot, här anges som application/json, det vill säga JSON-format.
  • authorization: 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 behöver bearbetas.
  • encryption: valfritt, krypteringsparameter för känsliga fält (om krypterad information behöver skickas).
När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden nedan:

Klicka på knappen “Try” för att utföra ett test, som visas i bilden ovan, och vi får följande resultat: 
{
  "result": "0",
  "description": "Namn och ID-nummer överensstämmer",
  "name": "ID-kortsnamn",
  "id_card": "ID-nummer",
  "sex": "ID-kön",
  "nation": "ID-nation",
  "birth": "ID-födelsedatum",
  "address": "ID-hemadress"
}
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • result, verifieringsresultatkod, avgiftsinformation som följer.
    • Avgiftsresultatkod:
      • 0: Namn och ID-nummer överensstämmer
      • -1: Namn och ID-nummer överensstämmer inte
    • Avgiftsfria resultatkoder:
      • -2: Ogiltigt ID-nummer (längd, kontrollsiffra etc. är felaktiga)
      • -3: Ogiltigt namn (längd, format etc. är felaktiga)
      • -4: Tjänst för dokumentdatabas är felaktig
      • -5: Ingen ID-kortsregistrering finns i dokumentdatabasen
      • -6: Auktoritativ jämförelsesystem uppgraderas, vänligen försök igen senare
      • -7: Antalet verifieringar har överskridit dagens gräns.
  • description, resultatet av verifieringen av namn och ID-nummer.
  • name, namninformationen i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • id_card, ID-nummerinformationen 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, nationsinformationen i ID-kortet, om ingen ID-kortsbild har laddats upp är den tom.
  • birth, födelsedatuminformationen 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.
Det kan ses att namnet och ID-numret i ID-kortet är överensstämmande och giltiga, och dessutom har OCR-teknik använts för att extrahera och visa annan information. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan: 
curl -X POST 'https://api.acedata.cloud/identity/idcard/ocr' \
-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/ocr"

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)

​
Anpassad informationsverifiering

Vi erbjuder också ett sätt att verifiera utan att avslöja ID-kortsbildens information, där du endast kan ange namn name och ID-nummer id_card för att verifiera äktheten och överensstämmelsen av namn och ID-nummer. Här är de specifika uppgifterna som fyllts i:

När du klickar på körning får du följande resultat: 
{
    "address": "",
    "birth": "",
    "description": "Namn och ID-nummer överensstämmer",
    "id_card": "ID-nummer",
    "name": "ID-kortsnamn",
    "nation": "",
    "result": "0",
    "sex": ""
 }
Således, från resultatet ser vi att inga andra privata uppgifter avslöjas, och detta kan också slutföra verifieringen av äktheten och överensstämmelsen av namn och ID-nummer.

​
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: Felaktig begäran, troligen på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Felaktig begäran, troligen på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Internt 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

Genom detta dokument har du fått en förståelse för hur man använder ID-kortsigenkänning och informationsverifiering API för att verifiera äktheten och överensstämmelsen av namn och ID-nummer baserat på den angivna bilden eller informationen. 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.