API
Alle /ip*-Endpunkte geben die IP-Adresse des anfragenden
Clients zurück, wie sie fst.st sieht. Sie eignen sich zum Testen von
Skripten, Proxies oder Netzwerk-Setups.
Endpunkte
| Pfad | Format | Antwort |
|---|---|---|
/ip |
text/plain | Nur die IP-Adresse als Text. |
/ip.txt |
text/plain | identisch zu /ip. |
/ip.json |
application/json | IP-Adresse, optional erweiterbar über Query-Parameter (siehe unten). |
/ip.html |
text/html | Die IP-Adresse in einem minimalen HTML-Dokument. |
Eine unbekannte Dateiendung (z. B. /ip.xml) beantwortet
der Server mit 406 Not Acceptable.
Query-Parameter (nur /ip.json)
?verbose und ?debug wirken sich nur auf
/ip.json aus — /ip, /ip.txt und
/ip.html liefern immer nur die nackte IP-Adresse.
| Parameter | Zusätzliche Felder |
|---|---|
| (keiner) | ip |
?verbose |
ip, real-ip, x-forwarded-for, x-forwarded-by |
?debug |
wie ?verbose, zusätzlich host und socket-remoteAddr |
Sind beide Parameter gesetzt, gewinnt ?verbose (die
kürzere Feldliste).
Rate-Limit
Alle /ip*-Endpunkte sind pro Client-IP auf
60 Anfragen pro 60 Sekunden begrenzt (festes
Zeitfenster). Wird das Limit überschritten, antwortet der Server mit
429 Too Many Requests und einem Retry-After-Header
(Sekunden bis zum nächsten Zeitfenster). Andere Endpunkte wie
/version.json oder /candidate-urls sind
davon nicht betroffen.