API
Dezelfde gegevens als de website, als JSON of platte tekst. Geen sleutel, geen account; er gelden redelijke limieten.
curl https://ipaddress.tr/api/v1/my-ip?format=textEndpoints
| Pad | Beschrijving | Gegevens | Limieten |
|---|---|---|---|
| GET/api/v1/my-ipProberen: /api/v1/my-ip | Uw IP-adres (ook als platte tekst met ?format=text). | Eigen datasets | 120 · 240/min |
| GET/api/v1/ip/{address}Proberen: /api/v1/ip/144.122.145.153 | Netwerk-, routerings-, register- en locatiegegevens voor een adres. | Eigen datasets | 30 · 30/min |
| GET/api/v1/ip/geolocation?ip=Proberen: /api/v1/ip/geolocation?ip=177.224.0.1 | Alleen de locatieschatting van een adres (DB-IP Lite), altijd als schatting gemarkeerd. | Eigen datasets | 30 · 30/min |
| GET/api/v1/ip/asn?ip=Proberen: /api/v1/ip/asn?ip=2001:1208::1 | Het herkomst-AS en de aangekondigde prefix van een adres, en de registerdelegatie waarin het valt. | Eigen datasets | 30 · 30/min |
| GET/api/v1/ip/reverse?ip=Proberen: /api/v1/ip/reverse?ip=8.8.8.8 | Het PTR-record van een publiek adres, live, met voorwaartse bevestiging. | Live opvraging | 40 · 60/min |
| GET/api/v1/ip/blacklist?ip=Proberen: /api/v1/ip/blacklist?ip=8.8.8.8 | Live DNSBL-resultaten (SpamCop, PSBL, DroneBL, s5h.net) en de Tor-exitvlag voor een publiek adres. | Live opvraging | 40 · 60/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.tr/api/v1/bulk | Tot 100 adressen tegelijk (JSON {"addresses": […]} of één per regel), alleen beantwoord uit onze eigen datasets. Niets wordt opgeslagen. | Eigen datasets | 6 · 3/min |
| GET/api/v1/asn/{asn}Proberen: /api/v1/asn/AS8151 | Houder, register en aangekondigde prefixen van een autonoom systeem. | Eigen datasets | 30 · 30/min |
| GET/api/v1/network/{cidr}Proberen: /api/v1/network/144.122.0.0/16 | Een netwerk in CIDR-notatie: grootte, bereik, bijzondere status, wie het aankondigt (met RPKI), de registerdelegatie en een locatieschatting. | Eigen datasets | 30 · 30/min |
| GET/api/v1/network/ipv4?cidr=Proberen: /api/v1/network/ipv4?cidr=192.168.1.37/24 | Subnetberekening voor een IPv4- of IPv6-netwerk: netwerk, broadcast, maskers, bruikbaar bereik en aantallen. | Eigen datasets | 120 · 240/min |
| GET/api/v1/network/ipv6?cidr=Proberen: /api/v1/network/ipv6?cidr=2001:db8::/48 | Subnetberekening voor een IPv4- of IPv6-netwerk: netwerk, broadcast, maskers, bruikbaar bereik en aantallen. | Eigen datasets | 120 · 240/min |
| GET/api/v1/country/{cc}Proberen: /api/v1/country/MX | Geregistreerde adresruimte en AS-nummers van een land, wat de netwerken aankondigen, RPKI-dekking en de grootste netwerken (voor TR ook de schatting per provincie). | Eigen datasets | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXProberen: /api/v1/dns/metu.edu.tr?type=A,MX | Live DNS-records van een domein. | Live opvraging | 40 · 60/min |
| GET/api/v1/dns/propagation?name=&type=Proberen: /api/v1/dns/propagation?name=metu.edu.tr&type=A | Dezelfde DNS-vraag aan meerdere publieke resolvers, met elk antwoord en of ze overeenkomen. | Live opvraging | 40 · 60/min |
| GET/api/v1/rdap/{query}Proberen: /api/v1/rdap/AS8151 | Registratiegegevens van de bevoegde RDAP-server. | Live opvraging | 10 · 6/min |
| GET/api/v1/healthProberen: /api/v1/health | Beschikbaarheid van de dienst. | Eigen datasets | 120 · 240/min |
| GET/api/v1/data-statusProberen: /api/v1/data-status | Leeftijd en omvang van elke dataset. | Eigen datasets | 120 · 240/min |
Platte-tekstsnelkoppelingen buiten /api/v1: /raw toont uw adres, /json hetzelfde object als /my-ip, /country uw geschatte landcode.
Elk pad-endpoint heeft ook een queryvorm: /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Elke respons heeft een X-Request-Id-header.
curl ipaddress.tr/rawcurl ipaddress.tr/jsoncurl ipaddress.tr/countryLimieten
Verzoeken worden per clientadres beperkt met een token bucket. Bij het bereiken van de limiet antwoordt de API met 429 en een Retry-After-header. Limieten worden in het geheugen geteld met een gehashte, dagelijks wisselende sleutel; adressen worden niet opgeslagen.
Fouten
Fouten gebruiken HTTP-statuscodes en een JSON-body in de vorm {"error": {"code": "…", "message": "…"}}.
Versies
Paden onder /api/v1/ behouden hun responsstructuur. Nieuwe velden kunnen worden toegevoegd; bestaande velden worden binnen v1 niet verwijderd of hernoemd.
Bronvermelding
Locatiegegevens komen van DB-IP (CC BY 4.0). Toont u ze, vermeld DB-IP dan zoals de licentie vereist.