IP一括ルックアップAPIリファレンス
POST/v1/lookup
GET /v1/lookup/{ip}のバッチ版です—1回のバックエンドリクエストで最大100件のIPv4/IPv6アドレスを解決し、送信されたのと同じ順序で結果を返します。
認証
単一IPルックアップエンドポイントと同じ種類のキーとして、Authorization: Bearer YOUR_SECRET_KEYでシークレットキーを指定してください。
リクエストボディ
- ips
- 1〜100件のIPv4/IPv6アドレス文字列の配列。ルックアップが実行される前にバッチ全体が検証されます—不正な形式のアドレスが1件でもあると呼び出し全体が失敗します。
エラー
- 400
- ipsの配列が空である、100件を超えるIPが含まれている、または配列内のどこかにIPが不正な形式である。
- 401
- APIキーが欠落しているか無効です。
- 403
- シークレットキーの代わりに公開可能キーが使われました。
- 429
- 現在の1分間ウィンドウでレート制限を超えました。
例
リクエスト
curl https://api.watch-ip.com/v1/lookup \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"ips": ["203.0.113.1", "2001:db8::1"]}'レスポンス
{
"results": [
{ "ip": "203.0.113.1", "country": "US", "region": "TX", "city": "Austin", "postalCode": null, "latitude": 30.2672, "longitude": -97.7431, "continent": "NA", "timezone": null, "found": true },
{ "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
]
}制限
バッチ内の各IPは個別に課金・記録されます—100件のIPの呼び出しは1件ではなく100件のlookup利用イベントとして記録されます。同じIPを2回送信すると2回分課金されます。1分あたりのレート制限に対しては、呼び出し全体が1リクエストとして数えられます。このエンドポイントの位置情報データはDB-IPによって提供されています(IP Geolocation by DB-IP、db-ip.com—CC BY 4.0)。