net.my_ip Ihre IP-Adresse und andere Client-Parameter abfragen

Grundlagen

Die my_ip-action liefert Ihnen die IP-Adresse zurück, mit der Ihre Software die Informations-API anfrägt. Falls vorhanden, werden zusätzliche Daten wie HTTP_REFERER und REMOTE_CLIENT ebenfalls in die Antwort eingebettet.

API-Anfrage

Um Ihre IP-Adresse auszulesen, rufen Sie die API bitte mit dem Modul net und der action my_ip auf, weitere Optionen sind nicht möglich:

Übergeben Sie ein JSON-Objekt als String via POST oder GET aus Ihrer Software:

{
   "action" : "my_ip",
   "apikey" : "abcd1234",
   "modul" : "net"
}

Nutzen Sie die Punktnotation, um die Daten per POST oder GET an die API zu übertragen:

action=my_ip
apikey=abcd1234
modul=net
https://nettz.de/api.cgi?action=my_ip&apikey=abcd1234&modul=net

Übertragen Sie die Parameter per XML an die API:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<opt action="my_ip" apikey="abcd1234" modul="net" />

API-Anfrage-Optionen

Es sind keine zusätzlichen Parameter möglich.

API-Antwort

Die Antwort der API enthält im data-Objekt alle verfügbaren Informationen zu Ihrem Zugriff:

{
   "data" : {
      "ip" : "192.193.194.65",
      "request" : {
         "method" : "GET"
      },
      "useragent" : "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101 Firefox/68.0"
   },
   "status" : 1,
   "timestamp" : 1562615500
}
data.ip=192.193.194.65
data.request.method=GET
data.useragent=Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101 Firefox/68.0
status=1
timestamp=1562615500
data.ip=192.193.194.65&data.request.method=GET&data.useragent=Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64;%20rv:68.0)%20Gecko/20100101%20Firefox/68.0&status=1&timestamp=1562615500
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<opt status="1"
timestamp="1562615500">
<data ip="192.193.194.65"
useragent="Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101 Firefox/68.0">
<request method="GET" />
</data>
</opt>

Erklärung der data-Informationen

Die API-Antwort enthält mindestens die ip-Angabe, kann aber noch weitere Informationen beinhalten. Folgende Details können verfügbar sein:

  • ip - die IP-Adresse Ihres Client/Browser
  • useragent - die Kennung Ihres Browser/Client (HTTP_USER_AGENT)
  • request.method - Die Methode, mit der Sie auf die API zugegriffen haben (GET/POST/PUT)

Beispiel-Aufrufe und -Antworten

Es sind noch keine Beispiele hinterlegt

Quellen / Anbieter

Bei Nutzung dieser action werden nur interne Daten/Algorithmen genutzt.

Vergleichbare API-actions

  • net - Tools und Funktionen für LAN und das Internet
  • Info-Module - In Info-Modulen sind Tools und Infos gebündelt. Sehen Sie hier eine Übersicht aller Info-Module.

Aktueller Status

  • Level:
    Info-Module mit dem Status @lpha sind neu und noch nicht ausgiebig getestet. Produktive Anbindungen dieser action werden _nicht_ empfohlen! Feedback, Bugmeldungen und Verbesserungsvorschläge sind dagegen herzlich willkommen!
  • Credits pro Aufruf:
    0.001
  • Letzte Änderung:
    Noch keine Änderung