Digitale Vertrauensdienste

Digitale Vertrauensdienste, alle API-Dienste zur Verhinderung von Online-Betrug

Überprüfen Sie in nur wenigen Sekunden die Zuverlässigkeit und Gültigkeit der Daten Ihrer Kunden und Nutzer: von der Dokumentenprüfung und Datenauslesung über die Video-Identifikation bis hin zur Validierung von Mobilnummer, E-Mail, Links und IP-Adressen.

All das Wissen, das Sie benötigen

Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.

Nützliche Tipps für den Einstieg Digitale Vertrauensdienste

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.

API trust

Verwenden Sie die folgenden Endpunkte, um Telefonnummern, E-Mails, URLs, IP-Adressen, IBANs zu validieren oder eine Identitätsprüfung durchzuführen:

Telefon-Validierung (start)

POST /mobile-start/{mobile-phone-number}

Erstellt eine neue Anfrage zur Validierung einer Mobilfunknummer. Im Body können Callback-Parameter angegeben werden. Das System startet eine globale HLR-Abfrage für die angegebene Nummer.
Einige Mobilfunkanbieter und Netzüberlastungen können die Anfrage verzögern.
Wenn die Suche länger als 10 Sekunden dauert, erhalten Sie ein Teilergebnis mit dem Status "NEW" oder "WAIT". Warten Sie einfach auf eine Benachrichtigung, wenn die Suche abgeschlossen ist. Sie können den Status auch manuell über die GET-Methode und die bereitgestellte ID überprüfen.

E-Mail-Validierung (start)

POST /email-start/{email}

Erstellt eine neue Anfrage zur Validierung einer E-Mail-Adresse. Im Body können Callback-Parameter angegeben werden. Das System startet einen E-Mail-Validierungsprozess.
Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /email-start/{id} oder warten Sie auf den Callback.

Mobile-Validierung (erweitert)

POST /mobile-advanced/{mobile-phone-number}

Erstellt eine neue Anfrage für eine erweiterte Mobilfunkvalidierung, einschließlich Betrugsbewertung (Fraud Score), Anbieter, Leitungstyp und mehr. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /mobile-advanced/{id} oder warten Sie auf den Callback.

Telefon-Validierung (erweitert)

POST /phone-advanced/{phone-number}

Erstellt eine neue Anfrage für eine erweiterte Validierung JEDER Telefonnummer, einschließlich Betrugsbewertung, Anbieter, Leitungstyp und mehr. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /phone-advanced/{id} oder warten Sie auf den Callback.

E-Mail-Validierung (erweitert)

POST /email-advanced/{email}

Erstellt eine neue Anfrage für eine erweiterte E-Mail-Validierung, einschließlich Betrugsbewertung, Zustellbarkeit und Reputation. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /email-advanced/{id} oder warten Sie auf den Callback.

URL-Validierung (erweitert)

POST /url-advanced/{url}

Erstellt eine neue Anfrage zum Scannen einer URL auf Phishing, Malware und andere Bedrohungen sowie zur Bewertung des Risikoscores. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /url-advanced/{id} oder warten Sie auf den Callback.

IP-Validierung (erweitert)

POST /ip-advanced/{ip}

Erstellt eine neue Anfrage zur Analyse einer IP-Adresse auf Proxy-, VPN- oder TOR-Verbindungen sowie zur Bewertung ihres Betrugsscores und der Reputation. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /ip-advanced/{id} oder warten Sie auf den Callback.

IBAN-Validierung (start)

POST /iban-start/{iban}

Erstellt eine neue Anfrage zur Validierung einer International Bank Account Number (IBAN), zum Extrahieren detaillierter Bankfilialdaten und zur Überprüfung der SEPA-Erreichbarkeit. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /iban-start/{id} oder warten Sie auf den Callback.

IBAN-Validierung (erweitert)

POST /iban-advanced/{iban}

Erstellt eine neue Anfrage zur Validierung einer IBAN, zum Extrahieren detaillierter Bankfilialdaten und zur Überprüfung der SEPA-Erreichbarkeit. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /iban-advanced/{id} oder warten Sie auf den Callback.

IBAN-Validierung (Verification of Payee)

POST /iban-vop/{iban}

Erstellt eine neue Anfrage zur Validierung einer IBAN und zur Überprüfung der Identität des Zahlungsempfängers (Verification of Payee - VoP). Erfordert den Parameter 'name' im Anfrage-Body. Im Body können Callback-Parameter angegeben werden. Wenn die Validierung länger als einige Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Überprüfen Sie den Status manuell über GET /iban-vop/{id} oder warten Sie auf den Callback.

Identitätsprüfung (start)

POST /idv-flash-start

Erstellt eine neue Anfrage zur Durchführung einer Identitätsprüfung. Im Body können Callback-Parameter angegeben werden. Gibt eine Verifizierungs-URL zu einem QR-Code zurück. Folgen Sie dem Vorgang mit Ihrem Smartphone und warten Sie auf das Ergebnis (ca. 3 Min.). Der gesamte Prozess ist KI-verifiziert. Überprüfen Sie den Status manuell über GET /idv-flash-start/{id} oder warten Sie auf den Callback.

Identitätsprüfung (erweitert)

POST /idv-flash-advanced

Erstellt eine neue Anfrage zur Durchführung einer Identitätsprüfung. Im Body können Callback-Parameter angegeben werden. Gibt eine Verifizierungs-URL zu einem QR-Code zurück. Folgen Sie dem Vorgang mit Ihrem Smartphone und warten Sie auf das Ergebnis (ca. 3 Min.). Der gesamte Prozess ist KI-verifiziert und beinhaltet auch die Gesichtserfassung. Überprüfen Sie den Status manuell über GET /idv-flash-advanced/{id} oder warten Sie auf den Callback.

Identitätsprüfung (expert)

POST /idv-expert

Erstellt eine neue Anfrage zur Durchführung einer Identitätsprüfung. Im Body können Callback-Parameter angegeben werden. Gibt eine Verifizierungs-URL zu einem QR-Code zurück. Folgen Sie dem Vorgang mit Ihrem Smartphone und warten Sie auf das Ergebnis (ca. 3 Stunden). Der Verifizierungsprozess wird von einer KI durchgeführt und anschließend von einem Experten validiert. Überprüfen Sie den Status manuell über GET /idv-expert/{id} oder warten Sie auf den Callback.

Identitätsprüfung (zertifiziert)

POST /idv-certified

Erstellt eine neue Anfrage zur Durchführung einer Identitätsprüfung. Im Body können Callback-Parameter angegeben werden. Gibt eine Verifizierungs-URL zu einem QR-Code zurück. Folgen Sie dem Vorgang mit Ihrem Smartphone und warten Sie auf das Ergebnis (ca. 3 Stunden). Der Verifizierungsprozess wird von einer KI durchgeführt, von einem Experten validiert und von der ANSSI (Agence nationale de la sécurité des systèmes d'information) zertifiziert. Überprüfen Sie den Status manuell über GET /idv-certified/{id} oder warten Sie auf den Callback.

Abrufen einer Validierungsanfrage

GET /mobile-start/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /email-start/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /mobile-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /phone-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /email-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /url-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /ip-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /iban-start/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /iban-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /iban-vop/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen.

GET /idv-flash-start/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen. Sie können auch "front" oder "back" als zusätzlichen Parameter hinzufügen (z. B. GET /idv-flash-start/{id}/front), um das Vorder- bzw. Rückseitenbild des Dokuments abzurufen, oder alternativ den Header "Content-Type: application/pdf" mit nur der {id} verwenden, um einen vollständigen PDF-Bericht der Verifizierung mit beiden Bildern und den Verifizierungsdaten zu erhalten.

GET /idv-flash-advanced/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen. Sie können auch "front", "back" oder "face" als zusätzlichen Parameter hinzufügen (z. B. GET /idv-flash-advanced/{id}/face), um das Vorderseitenbild des Dokuments, das Rückseitenbild oder das erfasste Gesicht abzurufen, oder alternativ den Header "Content-Type: application/pdf" mit nur der {id} verwenden, um einen vollständigen PDF-Bericht der Verifizierung mit allen 3 Bildern und den Verifizierungsdaten zu erhalten.

GET /idv-expert/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen. Sie können auch "front", "back" oder "face" als zusätzlichen Parameter hinzufügen (z. B. GET /idv-expert/{id}/back), um das Vorderseitenbild des Dokuments, das Rückseitenbild oder das erfasste Gesicht abzurufen, oder alternativ den Header "Content-Type: application/pdf" verwenden, um einen vollständigen PDF-Bericht zu erhalten.

GET /idv-certified/{id}
Gibt die Details einer Anfrage zurück, um den Status ("state") zu überprüfen. Sie können auch "front", "back" oder "face" als zusätzlichen Parameter hinzufügen (z. B. GET /idv-certified/{id}/back), um das Vorderseitenbild des Dokuments, das Rückseitenbild oder das erfasste Gesicht abzurufen, oder alternativ den Header "Content-Type: application/pdf" verwenden, um einen vollständigen PDF-Bericht zu erhalten.

GET /idv-retry/{id}
Aktualisiert die Verifizierungssitzung für fehlgeschlagene oder nicht eindeutige Versuche und gibt eine neue verificationUrl zurück. Nur für bestimmte Fehlerstatus und innerhalb des Versuchslimits zulässig.

GET /idv-audit-trail/{id}
Gibt die vollständigen Details der Versuche, Sitzungen und Ergebnisse im Zusammenhang mit der Verifizierung zurück.

Trust (1.0.0)

Verwenden Sie diese API, um die Gültigkeit und Vertrauenswürdigkeit von Daten wie E-Mail-Adressen und Mobiltelefonnummern zu überprüfen.

HLR

abfrage "Home Location Register" für die Validierung von Mobiltelefonnummern

Eine Anfrage zurückholen

Gibt ein Anfragedetail zurück, um den "Zustand" zu überprüfen

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 66c881896de559cb65055392

die mit der "POST"-Methode erhaltene Anfrage-ID

Responses

Response Schema: application/json
object (mobile-start)
success
boolean
message
string
error
string

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://trust.openapi.com/mobile-start/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": ""
}

Erstellen einer neuen HLR-Anfrage

Erstellen Sie eine neue Anfrage, der Body Post wird verwendet, um "Callback"-Parameter anzugeben. Das System startet eine globl HLR-Suche für die angegebene Telefonnummer.
Einige Mobilfunkanbieter und Netzüberlastungen können die Anfrage verlangsamen. Wenn die Suche länger als 10 Sekunden dauert, erhalten Sie ein Teilergebnis mit dem Status "NEU" oder "WARTEN". Warten Sie einfach auf eine Benachrichtigung, wenn die Suche abgeschlossen ist. Sie können den Status auch manuell mit der GET-Methode und der angegebenen ID überprüfen.

Authorizations:
bearerAuth
path Parameters
mobile-phone-number
required
string
Example: +393939989747

Das Mobiltelefon mit der internationalen Vorwahl

Request Body schema: application/json
object

Dies ist unser standardisiertes OpenAPI-Callback-System. Es ermöglicht die Konfiguration von Parametern für den Empfang von Benachrichtigungen über Statusaktualisierungen von asynchronen Anfragen an diesen Endpunkt.

Responses

Response Schema: application/json
object (mobile-start)
success
boolean
message
string
error
string

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Email

E-Mail-Validierungsdienste

Abrufen einer E-Mail-Validierungsanfrage

Gibt ein Detail einer E-Mail-Validierungsanfrage zurück, um den "Status" und die Ergebnisse zu überprüfen.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 77e9e92216065fa37f3c9842

Mit der Methode POST /email-start/{email} erhaltene Anfrage-ID

Responses

Response Schema: application/json
object (email-start)
success
boolean
message
string
error
string

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://trust.openapi.com/email-start/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Erstellen Sie eine neue E-Mail-Validierungsanfrage

Erstellen Sie eine neue Anfrage zur Validierung einer E-Mail-Adresse. Im Textkörper können Rückrufparameter angegeben werden. Das System startet einen E-Mail-Validierungsprozess. Wenn die Validierung länger als ein paar Sekunden dauert, erhalten Sie möglicherweise ein Teilergebnis mit dem Status 'NEW' oder 'WAIT'. Prüfen Sie den Status manuell mit GET /email-start/{id} oder warten Sie auf den Rückruf.

Authorizations:
bearerAuth
path Parameters
email
required
string <email>

Die zu überprüfende E-Mail-Adresse.

Request Body schema: application/json
object

Dies ist unser standardisiertes OpenAPI-Callback-System. Es ermöglicht die Konfiguration von Parametern für den Empfang von Benachrichtigungen über Statusaktualisierungen von asynchronen Anfragen an diesen Endpunkt.

Responses

Response Schema: application/json
object (email-start)
success
boolean
message
string
error
string

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}