Die United-Hosting API

Mit unserer neuen API Schnittstelle erhälst Du neue Möglichkeiten, Deine Softwareprojekte noch schneller und einfacher zu entwickeln. Unser Motto für die APIs lautet: keine Gebühren für Abfragen, dafür ein Fair Use Konzept, von dem jeder was hat!

Unsere Abfrageregeln sind sehr übersichtlich:

  • Alle API Angebote sind kostenlos
  • Jeder User erhält einen API Key
  • Es sind bis zu 50.000 Abfragen pro Tag erlaubt
  • Der Key ist erst wieder am nächsten Tag bei Überanspruchung aktiv
  • Seid bitte so nett und nutzt nur einen Account!

Wie Ihr seht sind unsere Regeln relativ einfach gehalten. Natürlich solltet Ihr euch daran halten. Wir machen das für die Community und wollen euch damit einen weiteren kostenlosen Service bieten. Was an API Angeboten hier erscheint ist nicht nur auf uns begrenzt. Jeder der kann, darf uns seine Vorschläge oder seinen Code zusenden und wir stellen dafür die Software als API über unsere Server bereit.



API Key abrufen

API Überblick

Advanced IP/DNS API

WICHTIG: Diese API befindet sich im BETA Status und kann u.U. noch diverse Probleme/Fehler beinhalten. Benutzung im Livebetrieb also auf eigene Gefahr!!!

Mit unserer neuen IP API könnt Ihr nicht nur IP Adressen datenschutzkonform untersuchen, sondern auch diverse Domain Einträge einsehen, unter anderem NS, A, TXT und SRV Records. Dabei ist es egal, was Ihr an Daten angebt, ob es eine IP oder Domain ist erkennt unser System selbst!

API Aufruf via GET:

Die API ist aktuell nur via GET Aufruf und einem gültigen API Key erreichbar. Hier eine Beispielabfrage:

https://united-hosting.eu/api/?type=ip&api_key=ABCDEFGHIJKLMNOP&addr=uhmail.eu

Hier rufen wir die .EU Domain "uhmail.eu" auf. Pflichtparameter sind: type, api_key und addr. Als Antwort gibt uns die API nun folg. Informationen zurück:

{
  "ServiceInfo": {
    "ApiVersion": "1.13",
    "ServiceStatus": "OK",
    "ApiKey": "ABCDEFGHIJKLMNOP",
    "Type": "ip",
    "YourIp": "91.222.333.444",
    "restApiCallsToday": 49986
  },
  "Api": {
    "ApiCall": "Success",
    "ApiCallType": "ADVANCED IP/DNS API"
  },
  "Answer": {
    "RemoteAddress": "93.104.209.49",
    "Type": "IPv4",
    "Hostname": "united-hosting.eu",
    "Asn": "8767 - MNET-AS",
    "Isp": "Mnet",
    "Connection": "Wireless",
    "Organization": "Contabo GmbH",
    "Country": "DE",
    "State": "Bavaria",
    "District": "Upper Bavaria",
    "City": "Munich (Ramersdorf-Perlach)",
    "Lat": "48.1046",
    "Lon": "11.6002",
    "TimeZone": "Europe/Berlin (UTC+2)",
    "IsRobot": "No",
    "IsProxy": "No",
    "IsAttackSource": "No",
    "IsVPN": "No",
    "IsServer": "Yes",
    "IsTorNode": "No",
    "WarningLevel": "15",
    "IsDomain": "Yes",
    "DnsRecords": {
      "1": {
        "Type": "A",
        "Host": "uhmail.eu",
        "Ip": "93.104.209.49",
        "Ttl": "3599 seconds"
      }
    }
  }
}

Genau das gleiche können wir auch mit einer IP Adresse machen:

https://united-hosting.eu/api/?type=ip&api_key=ABCDEFGHIJKLMNOP&addr=8.8.8.8

Das Ergebnis ist vergleichbar wie oben, nur dass der isDomain Code = 0 ist und keine Domain Informationen erscheinen.

Die Antwort vom Webserver ist immer im JSON Format!

 

Ist die API Datenschutzkonform?

Ja! Wir speichern nur den Zeitstempel und den API Key, damit unser Zähler funktioniert und max. 50.000 Abfragen pro Tag möglich sind. Alles andere (wie z.B. die Client IP, die gesuchte IP/Domain und der Type werden nicht gespeichert. Somit benötigen Sie keine Anpassungen in Ihrer Datenschutzbestimmung für unseren Dienst, falls Sie IP/Domain Checks anbieten wollen. Natürlich müssen Sie für Ihren eigenen Service dies trotzdem machen.