Wir haben eine API (Schnittstelle zu tellows) erstellt, mit der ihr die Informationen zu einer Nummer in eigene Programme integrieren könnt. Die API richtet sich eher an Programmierer, die auf die Datenbasis von tellows zugreifen möchten. Wie die Datenbasis sich zusammensetzt und wie wir diese aktuell halten, findet ihr in unserem Blog-Artikel zur Spam-Datenbank.
Mit einer TK-Anlage, die Zugang zum Internet hat und API Keys nutzen kann, könnt ihr problemlos eine Echtzeit-Abfrage zum tellows Server integrieren. Auf Telefonanlagen (z.B. Asterisk) könnt ihr selbst entscheiden, was mit eingehenden Anrufen passieren soll. Wollt ihr bereits auf dem Display die Art des Anrufes (z. B. Werbeanruf) angezeigt bekommen, die Anrufe mit einem negativen Score auf den Anrufbeantworter umleiten oder Anrufe sämtlicher negativ bewerteter Rufnummern unterdrücken? Dank des tellows API Key ist das kein Problem. Sowohl Live-Abfragen als auch die Verwendung einer Blackliste über die Scorelist API ist möglich.
Wir empfehlen stets die Anwendung der Scorelist API, die eine Liste mit allen relevanten Telefonnummern und Details zur Nummer generiert und bei eingehenden Anrufen abgeglichen wird.
Vorteile der Scorelist API
- Täglicher Abruf der aktuellen Listen nach Parametern (z.B. Score, Anzahl der Kommentare)
- Übersichtliche Darstellung der relevantesten Datenfelder (meistgenannter Anrufername, Vorwahlbereich, meistgenannter Anrufertag)
- Schnelle Prüfung von Nummern mit der lokal gespeicherten Scorelist, da keine Echtzeit-Serveranfrage notwendig ist
Bei dem Request der Liste könnt ihr mit Parametern innerhalb der Download-URL die Ergebnisse individualisieren. Damit verfeinert ihr die Ausgabe und könnt z.B. nur Telefonnummern mit einem gewünschten Mindestscore oder einer Mindestanzahl von Kommentaren anzeigen lassen.
Beispielanwendungen
Eine Beispielanwendung ist die Integration in eine Asterisk-Telefonanlage, um den Score von Nummern zu verarbeiten und entsprechend zu reagieren.
Auf Github hat Volker Kettenbach seine Asterisk FastAGI Integration mit der tellows Sperrliste veröffentlicht: https://github.com/kettenbach-it/asterisk-fastagi-tellows
Für die Aktivierung wird anschließend nur der Lizenz-Key aus dem tellows Shop benötigt.
Ansprechen der API über Testzugang
http://www.tellows.de/basic/num/0781968053101?xml=1&partner=test&apikey=test123
Parameter in der URL
xml: 1 = XML-Ausgabe; 0 = HTML-Formatierte Ausgabe
partner: Partnerlogin wird über den Shop erworben
apikey: Schlüssel für Partnerlogin wird ebenfalls über den Shop erworben
Weiterlesen →