Sicherheitsdatenbanken

Einfach zu bedienende Anwendungsprogrammschnittstelle

SECDATA

»

API

Überblick
Leistungen
Eigenschaften
Technologie
API
Fragen
Preisgestaltung / Kauf
Lizenz

api

Hacker-IP-Adressdatenbank

Um die Hacker-IP-Adressdatenbank abzufragen, müssen Sie drei Parameter übergeben:
key Der Ihrem Konto zugeordnete Autorisierungsschlüssel. Dieser alphanumerische Wert identifiziert Ihr Konto eindeutig.
ip Die zu überprüfende IP-Adresse. Dabei kann es sich um eine IPv4- oder IPv6-Adresse handelt.
format Das für die Antwort gewünschte Format. Gültige Werte sind ‚x‘ (XML), ‚j‘ (JSON) und ‚p‘ (Plain Text).

Die Parameter können über die URL übergeben werden (mit einer GET-Methode) oder in der Anforderung übergeben werden (mit einer POST-Methode). Der tatsächlich zu verwendende Servername wird von Telium bei der Einrichtung Ihres Kontos (oder der Testversion) bereitgestellt. Eine Abfrage mit in der URL gesendeten Parametern sieht z. B. wie folgt aus:

http://xxxxx.telium.io/check-ipaddress?key=1111&ip=1.2.3.4&format=j

Die Antwort aus der Abfrage enthält vier Informationen:

result Das Ergebnis der Abfrage. Gültige Werte sind 0 (Erfolg), 1 (Konto ungültig), 2 (Konto noch nicht gültig), 3 (Konto abgelaufen), 4 (Dienstfehler)
ip Die IP-Adresse, die SecDataübereinstimmt. Dabei kann es sich entweder um die exakte IP-Adresse sein, die an SecDataübergeben wird, oder um eine zugeordnete IP-Adresse, wie sie von SecDatagefunden wird.
match Der Typ der gefundenen Übereinstimmung. Gültige Werte sind ‚0‘ (keine), ‚1‘ (genaue Übereinstimmung), ‚2‘ (entspricht der zugeordneten Adresse).
risk Das Risiko, dass die IP-Adresse mit Hacking verbunden ist. Gültige Werte reichen von 0 (niedrig) bis 100 (hoch).

Die Antwort auf das obige Beispiel würde wie folgt aussehen:

{„result“:0,“ip“:“1.2.3.22″,“match“:2,“risk“:20}

Betrugs-Telefonnummerndatenbank

Um die Betrugs-Telefonnummerndatenbank abzufragen, müssen Sie vier Parameter übergeben:
key Der Ihrem Konto zugeordnete Autorisierungsschlüssel. Dieser alphanumerische Wert identifiziert Ihr Konto eindeutig.
phone Die Telefonnummer, die Sie überprüfen möchten. Dies ist die unformatierte Telefonnummer als gewählt (einschließlich optionaler Außenzeilenzugriffsziffern, internationaler Anrufpräfix, Ländervorwahl usw.).
region Die Region, in der sich die Nebenstellenanlage befindet, in der eine gültige Telefonnummernstruktur entschlüsselt wird. Der Regionscode ist ein 2-Buchstaben-Code im Sinne von ISO 3166-2.
format Das für die Antwort gewünschte Format. Gültige Werte sind ‚x‘ (XML), ‚j‘ (JSON) und ‚p‘ (Plain Text).

Die Parameter können über die URL übergeben werden (mit einer GET-Methode) oder in der Anforderung übergeben werden (mit einer POST-Methode). Der tatsächlich zu verwendende Servername wird von Telium bei der Einrichtung Ihres Kontos (oder der Testversion) bereitgestellt. Eine Abfrage mit in der URL gesendeten Parametern sieht z. B. wie folgt aus:

http://xxxxx.telium.io/check-phonenumber?key=1111&phone=1235551212&region=ca&format=j

Die Antwort aus der Abfrage enthält fünf Informationen:

result Das Ergebnis der Abfrage. Gültige Werte sind 0 (Erfolg), 1 (Konto ungültig), 2 (Konto noch nicht gültig), 3 (Konto abgelaufen), 4 (Dienstfehler)
rawphone Die unformatierte Telefonnummer, die an SecDataübergeben wird.
localphone Die lokalisierte Telefonnummer, wie sie von SecDatainterpretiert wird. Dazu gehören das Entfernen von Wählpräfixen und die Interpretation von Zahlenkomponenten. Bei einer ungültigen unbeschriebenen Rohtelefonnummer ist dieser Wert leer.
match Der Typ der gefundenen Übereinstimmung. Gültige Werte sind ‚0‘ (keine), ‚1‘ (match raw phone number), ‚2‘ (match localized phone number), ‚3‘ (match raw and localized phone numbers)
risk Das Risiko, dass die Telefonnummer mit Betrug verbunden ist. Gültige Werte reichen von 0 (niedrig) bis 100 (hoch).

Die Antwort auf das obige Beispiel würde wie folgt aussehen:

{„result“:0,“rawphone“:“914165551212″,“localphone“:“4165551212″,“match“:3,“risk“:60}