API
Web sitesiyle aynı veriler, JSON veya düz metin olarak. Anahtar ve hesap gerekmez; makul kullanım sınırları uygulanır.
curl https://ipaddress.pt/api/v1/my-ip?format=textUç noktalar
| Yol | Açıklama | Veri | Hız sınırları |
|---|---|---|---|
| GET/api/v1/my-ipDene: /api/v1/my-ip | IP adresiniz (?format=text ile düz metin olarak da). | Kendi veri kümelerimiz | 120 · 240/dk |
| GET/api/v1/ip/{address}Dene: /api/v1/ip/1.1.1.1 | Bir adres için ağ, yönlendirme, kayıt ve konum verileri. | Kendi veri kümelerimiz | 30 · 30/dk |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.pt/api/v1/bulk | Tek seferde en fazla 100 adres (JSON {"addresses": […]} ya da satır başına bir adres), yalnızca kendi veri setlerimizden yanıtlanır. Hiçbir şey saklanmaz. | Kendi veri kümelerimiz | 6 · 3/dk |
| GET/api/v1/asn/{asn}Dene: /api/v1/asn/AS3243 | Bir otonom sistemin sahibi, kayıt kuruluşu ve duyurduğu önekler. | Kendi veri kümelerimiz | 30 · 30/dk |
| GET/api/v1/network/{cidr}Dene: /api/v1/network/193.136.0.0/15 | CIDR gösterimindeki bir ağ: boyut, aralık, özel amaçlı durum, onu kimin duyurduğu (RPKI ile), kayıt devri ve konum tahmini. | Kendi veri kümelerimiz | 30 · 30/dk |
| GET/api/v1/country/{cc}Dene: /api/v1/country/PT | Bir ülkeye kayıtlı adres alanı ve AS numaraları, ağlarının duyurdukları, RPKI kapsamı ve en büyük ağlar (PT için bölge başına tahmin de). | Kendi veri kümelerimiz | 30 · 30/dk |
| GET/api/v1/dns/{domain}?type=A,MXDene: /api/v1/dns/dns.pt?type=A,MX | Bir alan adının güncel DNS kayıtları. | Canlı sorgu | 40 · 60/dk |
| GET/api/v1/rdap/{query}Dene: /api/v1/rdap/AS3243 | Sorumlu RDAP sunucusundan kayıt verileri. | Canlı sorgu | 10 · 6/dk |
| GET/api/v1/healthDene: /api/v1/health | Hizmetin çalışıp çalışmadığı. | Kendi veri kümelerimiz | 120 · 240/dk |
| GET/api/v1/data-statusDene: /api/v1/data-status | Her veri kümesinin yaşı ve boyutu. | Kendi veri kümelerimiz | 120 · 240/dk |
/api/v1 dışındaki düz metin kısayolları: /raw adresinizi, /json /my-ip ile aynı nesneyi, /country tahmini ülke kodunu verir.
curl ipaddress.pt/rawcurl ipaddress.pt/jsoncurl ipaddress.pt/countryHız sınırları
İstekler istemci adresi başına bir jeton kovasıyla sınırlanır. Sınıra ulaşıldığında API, Retry-After başlığıyla 429 döndürür. Sayım bellekte, her gün değişen karma bir anahtarla yapılır; adresler saklanmaz.
Hatalar
Hatalar HTTP durum kodlarını ve {"error": {"code": "…", "message": "…"}} biçiminde bir JSON gövdesini kullanır.
Sürümler
/api/v1/ altındaki yollar yanıt yapısını korur. Yeni alanlar eklenebilir; mevcut alanlar v1 içinde kaldırılmaz veya yeniden adlandırılmaz.
Kaynak gösterme
Konum verileri DB-IP'den (CC BY 4.0) gelir. Gösterirseniz, lisansın gerektirdiği şekilde DB-IP'yi kaynak olarak belirtin.