Zum Hauptinhalt springen

​
Einführung

Identity ist ein Authentifizierungsdienst von Ace Data Cloud zur Echtzeitverifizierung von Personalausweis, Bankkarte und Telefonnummer. Über die einheitliche API von Ace Data Cloud können Sie Identity mit JavaScript schnell integrieren und Funktionen wie Personalausweis-OCR, Personalausweisprüfung, Bankkartenprüfung und Telefonnummernprüfung realisieren.

​
Voraussetzungen

  • Ein Ace Data Cloud Konto und ein API-Token
  • Node.js 18+ oder eine moderne Browserumgebung

​
Grundlegende Verwendung

Der Hauptendpunkt für den Aufruf der Identity API lautet: 
POST https://api.acedata.cloud/identity/idcard/ocr
Vollständiges JavaScript-Beispiel: 
const response = await fetch("https://api.acedata.cloud/identity/idcard/ocr", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "image_url": "https://example.com/idcard-front.jpg"
}),
});

const result = await response.json();
console.log(result);
Bitte ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

​
Antwortverarbeitung

Es wird empfohlen, den Statuscode der Antwort zu prüfen und Fehler zu behandeln: 
if (response.ok) {
  const result = await response.json();
  console.log("Aufruf erfolgreich:", result);
} else {
  console.error(`Aufruf fehlgeschlagen, Statuscode: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Node.js Wrapper

Es wird empfohlen, eine wiederverwendbare Funktion zu erstellen: 
async function callIdentity(data) {
  const response = await fetch("https://api.acedata.cloud/identity/idcard/ocr", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API Fehler: ${response.status}`);
  return response.json();
}

​
Fehlerbehandlung

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

​
Nächste Schritte