Zum Hauptinhalt springen

​
Einführung

Identity ist ein Authentifizierungsdienst von Ace Data Cloud zur Verifizierung von Personalausweis, Bankkarte und Handynummer. Über die einheitliche API von Ace Data Cloud können Sie mit Python schnell Identity integrieren und Funktionen wie Personalausweis-OCR, Personalausweis-Validierung, Bankkarten-Validierung und Handynummern-Validierung nutzen.

​
Voraussetzungen

  • Ein Ace Data Cloud Konto und ein API Token
  • Python 3.7 oder höher
  • Installation der requests-Bibliothek: pip install requests

​
Grundlegende Verwendung

Der Hauptendpunkt für den Aufruf der Identity API ist: 
POST https://api.acedata.cloud/identity/idcard/ocr
Vollständiges Python-Codebeispiel: 
import requests

url = "https://api.acedata.cloud/identity/idcard/ocr"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "image_url": "https://example.com/idcard-front.jpg"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Bitte ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

​
Antwortverarbeitung

Nach einem erfolgreichen Aufruf gibt die API Daten im JSON-Format zurück. Es wird empfohlen, den HTTP-Statuscode zu prüfen: 
if response.status_code == 200:
    result = response.json()
    print("Aufruf erfolgreich:", result)
else:
    print(f"Aufruf fehlgeschlagen, Statuscode: {response.status_code}")
    print(response.text)

​
Erweiterte Verwendung

Für APIs, die asynchrone Aufgaben unterstützen, können Sie Ergebnisse über eine Callback-URL erhalten: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Das Ergebnis wird an Ihre Server-Callback-URL gesendet

​
Fehlerbehandlung

Häufige Fehlercodes:
StatuscodeBeschreibung
401Authentifizierung fehlgeschlagen, bitte API Token prüfen
403Unzureichendes Guthaben oder kein Zugriff
429Anfragerate überschritten
500Interner Serverfehler

​
Weitere Endpunkte

Der Identity-Dienst bietet außerdem folgende Endpunkte an:
  • POST https://api.acedata.cloud/identity/idcard/check-1e
  • POST https://api.acedata.cloud/identity/bankcard/check-1e
  • POST https://api.acedata.cloud/identity/phone/check-1e

​
Nächste Schritte