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.

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 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 oder 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'.

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.

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.

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.

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 des Betrugsscores und der Reputation.

Identitätsprüfung (start)

POST /idv-flash-start

Erstellt eine neue Anfrage zur Durchführung einer Identitätsprüfung. Gibt eine Verifizierungs-URL zu einem QR-Code zurück. Folgen Sie dem Vorgang mit Ihrem Smartphone (Dauer ca. 3 Min.). Der gesamte Prozess ist KI-verifiziert.

Identitätsprüfung (erweitert)

POST /idv-flash-advanced

Erstellt eine neue Anfrage zur Durchführung einer Identitätsprüfung inklusive Gesichtserkennung. Folgen Sie dem Vorgang mit Ihrem Smartphone (Dauer ca. 3 Min.). KI-verifiziert.

Identitätsprüfung (expert)

POST /idv-expert

Erstellt eine neue Anfrage zur Identitätsprüfung. Das Ergebnis liegt nach ca. 3 Stunden vor. Der Prozess wird von einer KI durchgeführt und anschließend von einem Experten validiert.

Identitätsprüfung (zertifiziert)

POST /idv-certified

Erstellt eine neue Anfrage zur Identitätsprüfung (Dauer ca. 3 Std.). Der Prozess wird von der KI durchgeführt, von einem Experten validiert und von der ANSSI (Agence nationale de la sécurité des systèmes d'information) zertifiziert.

Abrufen einer Validierungsanfrage

GET /mobile-start/{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. Sie können auch "front" oder "back" als zusätzlichen Parameter hinzufügen (z. B. GET /idv-flash-start/{id}/front), um das Vorder- oder Rückseitenbild des Dokuments abzurufen, oder den Header "Content-Type: application/pdf" verwenden, um einen vollständigen PDF-Bericht zu erhalten.

GET /idv-flash-advanced/{id}
Gibt die Details zurück. Parameter "front", "back" oder "face" möglich. Alternativ Header "Content-Type: application/pdf" für einen vollständigen Bericht mit allen 3 Bildern nutzen.

Oas file url trust.openapi.json
PDF Documentation
Fork or import with Postman
Production domain trust.openapi.com
Sandbox domain test.trust.openapi.com
Production Scopes 22

Rate Limits: 10000 req/min
Sandbox Scopes 22
- GET test.trust.openapi.com/email-advanced
- GET test.trust.openapi.com/email-start
- GET test.trust.openapi.com/idv-certified
- GET test.trust.openapi.com/idv-expert
- GET test.trust.openapi.com/idv-flash-advanced
- GET test.trust.openapi.com/idv-flash-start
- GET test.trust.openapi.com/ip-advanced
- GET test.trust.openapi.com/mobile-advanced
- GET test.trust.openapi.com/mobile-start
- GET test.trust.openapi.com/phone-advanced
- GET test.trust.openapi.com/url-advanced
- POST test.trust.openapi.com/email-advanced
- POST test.trust.openapi.com/email-start
- POST test.trust.openapi.com/idv-certified
- POST test.trust.openapi.com/idv-expert
- POST test.trust.openapi.com/idv-flash-advanced
- POST test.trust.openapi.com/idv-flash-start
- POST test.trust.openapi.com/ip-advanced
- POST test.trust.openapi.com/mobile-advanced
- POST test.trust.openapi.com/mobile-start
- POST test.trust.openapi.com/phone-advanced
- POST test.trust.openapi.com/url-advanced

Trust (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

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

Zum ersten Mal hier? Generieren Sie ein neues Zugangstoken

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

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": {
- "isPossible": true,
- "isValid": true,
- "regionCode": "IT",
- "isValidNumberForRegion": true,
- "numberType": "MOBILE",
- "requestedNumber": "00393332114774",
- "formattedNumber": "+393332114774",
- "createdAt": "2024-09-06T13:56:19+00:00",
- "updatedAt": "2024-09-06T13:56:19+00:00",
- "state": "DONE",
- "network": "MNO - Vodafone Italy",
- "originalNetwork": "MNO - TIM (Telecom Italia SpA)",
- "roaming": false,
- "ported": true,
- "country": "Italy",
- "countryPrefix": "39",
- "details": "DELIVERED_TO_HANDSET",
- "id": "66db0a03e8ba8710290e3c0f"
},
"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

{

"callback": {
- "url": "https://your-server.site/123232",
- "custom": {
  - "myKey": "myValue"
  }
}

}

Response samples

Content type

application/json

{

"data": {
- "isPossible": true,
- "isValid": true,
- "regionCode": "IT",
- "isValidNumberForRegion": true,
- "numberType": "MOBILE",
- "requestedNumber": "00393332114474",
- "formattedNumber": "+393332114474",
- "createdAt": "2024-09-06T13:56:19+00:00",
- "updatedAt": "2024-09-06T13:56:19+00:00",
- "state": "DONE",
- "network": "MNO - Vodafone Italy",
- "originalNetwork": "MNO - TIM (Telecom Italia SpA)",
- "roaming": false,
- "ported": true,
- "country": "Italy",
- "countryPrefix": "39",
- "details": "DELIVERED_TO_HANDSET",
- "id": "66db0a03e8ba8710290e3c0f"
},
"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

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": {
- "email": "[email protected]",
- "validSpf": false,
- "validDmarc": true,
- "spfDetails": {
  - "domain": "openapi.com",
  - "dnsServerUsed": "1.1.1.1",
  - "queriedDnsForTxt": true,
  - "selectedSpfRecord": "v=spf1 include:spf.mailtrusted.org include:emsd1.com include:mailgun.org -all",
  - "formalValidity": {
    "startsWithVspf1": true,
    "hasValidAllMechanism": false,
    "dnsMechanismLookupCount": 10,
    "maxDnsMechanismLookups": 10,
    "voidLookupCount": 0,
    "maxVoidLookups": 2,
    "hasRedirectModifier": false,
    "redirectDomain": null,
    "syntaxErrors": [
    "DNS lookup limit at 'include:_spf2.mailgun.org'."
    ],
    "warnings": [ ],
    "explanationDomain": null
    },
  - "parsedMechanisms": [
    {
    "term": "include:spf.mailtrusted.org",
    "mechanism": "include",
    "value": "spf.mailtrusted.org",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    },
    {
    "term": "include:emsd1.com",
    "mechanism": "include",
    "value": "emsd1.com",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    }
    ],
  - "allMechanismDetails": null,
  - "collectedIpAddresses": {
    "ip4": [
    "207.180.201.22",
    "207.180.222.205",
    "207.180.226.204",
    "etc"
    ],
    "ip6": [
    "2001:4860:4000::/36",
    "2404:6800:4000::/36",
    "etc"
    ],
    "fromA": [ ],
    "fromMx": [ ]
    },
  - "summary": {
    "totalDnsMechanismLookupsUsed": 10,
    "finalProcessingResult": "PERMERROR",
    "evaluationLog": [ ]
    }
  },
- "dmarcDetails": {
  - "recordFound": true,
  - "record": "v=DMARC1; p=none",
  - "dnsQueryDomain": "_dmarc.openapi.com",
  - "dnsServerUsed": "8.8.8.8",
  - "policy": "none",
  - "subdomainPolicy": null,
  - "alignmentDkim": "r",
  - "alignmentSpf": "r",
  - "percentage": 100,
  - "reportingUrisAggregate": [ ],
  - "reportingUrisFailure": [ ],
  - "failureOptions": [ ],
  - "errors": [ ],
  - "warnings": [ ]
  },
- "requestedEmail": "[email protected]",
- "createdAt": "2025-05-27T12:58:39+00:00",
- "updatedAt": "2025-05-27T12:58:40+00:00",
- "state": "NEW",
- "id": "6835b6fff6722090d00e74fb"
},
"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

required

string <email>

Example: [email protected]

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

Request Body schema: application/json

object

Responses

Response Schema: application/json

	object (email-start)
success	boolean
message	string
error	string

Request samples

Content type

application/json

{

"callback": {
- "url": "https://your-server.site/email-callback",
- "custom": {
  - "orderId": "email-check-456"
  }
}

}

Response samples

Content type

application/json

{

"data": {
- "email": "[email protected]",
- "validSpf": false,
- "validDmarc": true,
- "spfDetails": {
  - "domain": "openapi.com",
  - "dnsServerUsed": "1.1.1.1",
  - "queriedDnsForTxt": true,
  - "selectedSpfRecord": "v=spf1 include:spf.mailtrusted.org include:emsd1.com include:mailgun.org -all",
  - "formalValidity": {
    "startsWithVspf1": true,
    "hasValidAllMechanism": false,
    "dnsMechanismLookupCount": 10,
    "maxDnsMechanismLookups": 10,
    "voidLookupCount": 0,
    "maxVoidLookups": 2,
    "hasRedirectModifier": false,
    "redirectDomain": null,
    "syntaxErrors": [
    "DNS lookup limit at 'include:_spf2.mailgun.org'."
    ],
    "warnings": [ ],
    "explanationDomain": null
    },
  - "parsedMechanisms": [
    {
    "term": "include:spf.mailtrusted.org",
    "mechanism": "include",
    "value": "spf.mailtrusted.org",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    },
    {
    "term": "include:emsd1.com",
    "mechanism": "include",
    "value": "emsd1.com",
    "qualifier": "+",
    "lookupCost": 1,
    "isVoidLookup": false,
    "ipsFound": [ ],
    "effectiveResultIfMatched": "PASS",
    "includedReport": {
    "recurse": "all submechanisms included"
    }
    }
    ],
  - "allMechanismDetails": null,
  - "collectedIpAddresses": {
    "ip4": [
    "207.180.201.22",
    "207.180.222.205",
    "207.180.226.204",
    "etc"
    ],
    "ip6": [
    "2001:4860:4000::/36",
    "2404:6800:4000::/36",
    "etc"
    ],
    "fromA": [ ],
    "fromMx": [ ]
    },
  - "summary": {
    "totalDnsMechanismLookupsUsed": 10,
    "finalProcessingResult": "PERMERROR",
    "evaluationLog": [ ]
    }
  },
- "dmarcDetails": {
  - "recordFound": true,
  - "record": "v=DMARC1; p=none",
  - "dnsQueryDomain": "_dmarc.openapi.com",
  - "dnsServerUsed": "8.8.8.8",
  - "policy": "none",
  - "subdomainPolicy": null,
  - "alignmentDkim": "r",
  - "alignmentSpf": "r",
  - "percentage": 100,
  - "reportingUrisAggregate": [ ],
  - "reportingUrisFailure": [ ],
  - "failureOptions": [ ],
  - "errors": [ ],
  - "warnings": [ ]
  },
- "requestedEmail": "[email protected]",
- "createdAt": "2025-05-27T12:58:39+00:00",
- "updatedAt": "2025-05-27T12:58:40+00:00",
- "state": "NEW",
- "id": "6835b6fff6722090d00e74fb"
},
"success": true,
"message": "",
"error": null

}

Web Service Revision: 2.0.0