API
ウェブサイトと同じデータをJSONまたはプレーンテキストで提供します。キーもアカウントも不要で、妥当な利用制限があります。
curl https://ipaddress.se/api/v1/my-ip?format=textエンドポイント
| パス | 説明 | データ | レート制限 |
|---|---|---|---|
| GET/api/v1/my-ip試す: /api/v1/my-ip | あなたのIPアドレス（?format=textでプレーンテキストも可）。 | 自社データセット | 120 · 240/分 |
| GET/api/v1/ip/{address}試す: /api/v1/ip/81.224.0.1 | アドレスのネットワーク、ルーティング、レジストリ、位置データ。 | 自社データセット | 30 · 30/分 |
| GET/api/v1/asn/{asn}試す: /api/v1/asn/AS3301 | 自律システムの保有者、レジストリ、広報プレフィックス。 | 自社データセット | 30 · 30/分 |
| GET/api/v1/dns/{domain}?type=A,MX試す: /api/v1/dns/internetstiftelsen.se?type=A,MX | ドメインの最新DNSレコード。 | ライブ照会 | 40 · 60/分 |
| GET/api/v1/rdap/{query}試す: /api/v1/rdap/AS3301 | 担当RDAPサーバーからの登録データ。 | ライブ照会 | 10 · 6/分 |
| GET/api/v1/health試す: /api/v1/health | サービスの稼働状況。 | 自社データセット | 120 · 240/分 |
| GET/api/v1/data-status試す: /api/v1/data-status | 各データセットの鮮度とサイズ。 | 自社データセット | 120 · 240/分 |
レート制限
リクエストはクライアントアドレスごとにトークンバケットで制限されます。上限に達するとAPIはRetry-Afterヘッダー付きで429を返します。カウントはメモリ上で毎日変わるハッシュキーを使い、アドレスは保存しません。
エラー
エラーはHTTPステータスコードと {"error": {"code": "…", "message": "…"}} 形式のJSON本文で返します。
バージョン管理
/api/v1/ 以下のパスはレスポンス構造を維持します。フィールドの追加はありますが、v1内で既存フィールドの削除や名称変更はしません。
クレジット表記
位置データはDB-IP（CC BY 4.0）によるものです。表示する場合はライセンスに従いDB-IPを表記してください。