Offener DNS Resolver - REST API
Von Roman (romanf auf trash.net)
Die REST-API kann von praktisch jeder Programmiersprache oder auch von der Kommandozeile aus verwendet werden.
Koordinaten
- URL: https://your.trash.net/api_opendns.php
- Authentisierung: Via HTTP Basic-Authentication Header bei jedem Call als User "Bearer" und das Token (in den Self-Services hier erhältlich) als Passwort übergeben
- Method GET: Mit der HTTP Method "GET" wird die aktuelle Liste der für den Open DNS Resolver registrierten IP-Adressen/Ranges angezeigt. Es wird eine einfache, Komma-Separierte Liste zurück gegeben.
- Method POST: Mit der HTTP Method "POST" muss als Daten eine Zeile mit "ip=" direkt gefolgt von einer Komma-Separierten Liste der zu registrierenden IP-Adresssen/Ranges mitgegeben werden. Die im POST Call angegeben IP-Adresse/Ranges ersetzen die alten ohne Rückfrage!
Es werden keine anderen Methoden oder Operationen unterstützt (wie gesagt, ein einfaches API!).
Beispiele
CURL:
curl -u Bearer:<token> https://your.trash.net/api_opendns.php
curl -d "ip=<ip1>,<ip2>" -u Bearer:<token> https://your.trash.net/api_opendns.php
Hier muss natürlich <token> durch das Token und <ip> durch eine oder mehrere IP's ersetzt werden.
Hinweis: Wenn du den Offenen DNS Resolver produktiv verwendest und dann die API testest, dann kannst du dich ausschliessen (z.B. durch setzen von Test-IP...). Ist mir jedenfalls so passiert... zum Glück konnte ich dann über das Handy noch in die Self-Services und meine IP wieder manuell eintragen. :)