Sicherheitsdatenbanken

Einfach zu bedienende Anwendungsprogrammschnittstelle

SECDATA

»

API

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}