API
ウェブサイトと同じデータをJSONまたはプレーンテキストで提供します。キーもアカウントも不要で、妥当な利用制限があります。
curl https://ipaddress.fi/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/1.1.1.1 | アドレスのネットワーク、ルーティング、レジストリ、位置データ。 | 自社データセット | 30 · 30/分 |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.fi/api/v1/bulk | 一度に最大 100 件(JSON {"addresses": […]} または 1 行に 1 件)。当サイト独自のデータセットだけで回答し、何も保存しません。 | 自社データセット | 6 · 3/分 |
| GET/api/v1/asn/{asn}試す: /api/v1/asn/AS719 | 自律システムの保有者、レジストリ、広報プレフィックス。 | 自社データセット | 30 · 30/分 |
| GET/api/v1/dns/{domain}?type=A,MX試す: /api/v1/dns/traficom.fi?type=A,MX | ドメインの最新DNSレコード。 | ライブ照会 | 40 · 60/分 |
| GET/api/v1/rdap/{query}試す: /api/v1/rdap/AS1741 | 担当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を表記してください。