Τεκμηρίωση

API

HTTP και JSON API

Χωρίς έλεγχο ταυτότητας

Τα βασικά endpoints δεν απαιτούν λογαριασμό ή cookie. Οι δυναμικές αποκρίσεις χρησιμοποιούν Cache-Control: no-store και κεφαλίδες ορίου αιτημάτων.

API v1

Σταθερό JSON

JSON snake_case με έκδοση και σταθερό συμβόλαιο για την τρέχουσα και μια επιλεγμένη IP.

GET/api/v1/self

Δομημένο αποτέλεσμα τρέχουσας IP με πεδία δικτύου, τοποθεσίας και ASN.

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

Δομημένη αναζήτηση επικυρωμένης διεύθυνσης IPv4 ή IPv6.

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

Συμβατότητα

Διαδρομή	Απόκριση
`GET /`	Ρίζα με διαπραγμάτευση περιεχομένου: JSON για CLI και /, μία IP για text/plain και SSR HTML σε ρητό αίτημα text/html.
`GET /json`	Δομημένο αποτέλεσμα τρέχουσας IP με πεδία δικτύου, τοποθεσίας και ASN.
`GET /json/{ip}`	Δομημένη αναζήτηση επικυρωμένης διεύθυνσης IPv4 ή IPv6.
`GET /ip/{ip}`	Κανονικοποιημένη IP στόχου για προγράμματα· σελίδα noindex μόνο με ρητό αίτημα HTML.

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

Τερματικό

TEXT / ANSI

Διαδρομή	Απόκριση
`GET /ip`	Κανονικοποιημένη τρέχουσα IP και μία αλλαγή γραμμής.
`GET /info[/{ip}]`	Αναλυτικό κείμενο UTF-8 με σταθερές ετικέτες και σειρά, χωρίς κωδικούς ANSI.
`GET /ansi[/{ip}]`	Η προβολή /info με ρητά ενεργοποιημένα επιτρεπόμενα χρώματα SGR.
`GET /field/{field}[/{ip}]`	Μία επιτρεπόμενη τιμή και αλλαγή γραμμής· 204 όταν λείπει.

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

Μεθοδολογία και όρια σημάτων

Η υπηρεσία διαχωρίζει τα δεδομένα δικτύου που παρατηρεί ο διακομιστής, τα τοπικά γεωγραφικά δεδομένα και τα σήματα του προγράμματος περιήγησης.

Η εμφανιζόμενη δημόσια IP είναι η διεύθυνση που παρατήρησε η υπηρεσία για αυτή τη σύνδεση HTTP.
Χώρα, περιφέρεια, πόλη, ζώνη ώρας, συντεταγμένες, ASN και οργανισμός προέρχονται από τοπικό σύνολο δεδομένων.
Οι έλεγχοι WebRTC, DNS, γλώσσας, ζώνης ώρας και IPv6 είναι ανεξάρτητες παρατηρήσεις στο πρόγραμμα περιήγησης.
Μη διαθέσιμο, άγνωστο, χωρίς παρατήρηση και ασυμφωνία είναι διαφορετικές καταστάσεις.

Ακρίβεια και επικαιρότητα

Ο γεωεντοπισμός IP περιγράφει εκχώρηση δικτύου, όχι συσκευή ή κατοικία. Η πόλη και οι συντεταγμένες μπορεί να απέχουν· η ακτίνα ακρίβειας είναι εκτίμηση, όχι εγγύηση.

Απόρρητο και διατήρηση

Η αναζήτηση δεν αποθηκεύει ακατέργαστες IP, URI, κεφαλίδες ή αποτυπώματα στα συγκεντρωτικά PostgreSQL. Οι υπογεγραμμένοι σύνδεσμοι περιέχουν μόνο περιορισμένες καταστάσεις και λήγουν σε 24 ώρες.

Συχνές ερωτήσεις

Είναι η εμφανιζόμενη πόλη η ακριβής τοποθεσία μου;

Όχι. Ο γεωεντοπισμός IP είναι κατά προσέγγιση εκτίμηση σε επίπεδο δικτύου. Χρησιμοποιήστε την ακτίνα ακρίβειας και όχι ως ακριβή διεύθυνση.

Αποθηκεύει η υπηρεσία την αναζήτηση IP στη βάση δεδομένων;

Η εφαρμογή δεν αποθηκεύει ακατέργαστες διευθύνσεις IP στα συγκεντρωτικά χρήσης. Τα περιορισμένα αρχεία πρόσβασης διαχειρίζονται χωριστά.

Γιατί το IPv6 μπορεί να είναι άγνωστο αντί μη διαθέσιμο;

Ένας μη ρυθμισμένος, αποκλεισμένος ή ασαφής έλεγχος δεν αποδεικνύει απουσία IPv6· η κατάσταση μένει άγνωστη μέχρι σαφές αποτέλεσμα.

Τι περιέχει ένας κοινόχρηστος σύνδεσμος διάγνωσης;

Μόνο περιορισμένες τιμές κατάστασης, χρόνοι έκδοσης και λήξης και υπογραφή· χωρίς IP, συντεταγμένες ή διευθύνσεις DNS resolver.