/api/ip 向け IP検索APIガイド

このガイドを使って /api/ip に単一IP検索リクエストを送り、返ってくる JSON 項目を理解し、さらに文脈が必要になったら実際のブラウザワークフローに移ってください。

範囲は事実ベースに保ってください。/api/ip は1回に1件の公開IPを調べるための検索ヘルパーです。大量検索、認証付き、SLA付きのAPI製品ではありません。

Open IP lookup ネットワーク/セキュリティハブに戻る
こんなときに使う
1件の公開IP検索のJSON出力が必要で、fetch や CLI 呼び出しを自動化する前に正確なリクエストパターンを知りたい場合です。
現在の仕様
/api/ip には ip クエリパラメータが必要で、1回につき1件の公開IPに対するJSONの所有権コンテキストを返します。
ガードレール
無効、プライベート、または予約済みの入力はエラーJSONを返します。このエンドポイントは、大量検索、認証、稼働率の保証を約束するものではありません。
リクエストとレスポンスの例
ブラウザ fetch の例
フロントエンドやデバッグスクリプトで、ブラウザ検索と同じ ASN とネットワークコンテキストが必要な場合は、シンプルな GET リクエストを使ってください。 
fetch("/api/ip?ip=8.8.8.8")
  .then((response) => response.json())
  .then((data) => console.log(data));
CLI curl の例
プレーンテキストの /ip ターミナルショートカットではなく JSON が必要な場合は、ip クエリパラメータを明示的に送ってください。 
curl https://comutil.com/api/ip?ip=8.8.8.8
レスポンス項目の例
実際のエンドポイントは、現在の RDAP / WHOIS 検索フローから得た入れ子の network オブジェクトと、トップレベルの ASN メタデータを返します。 
{
  "asn_registry": "arin",
  "asn": "15169",
  "asn_cidr": "8.8.8.0/24",
  "asn_country_code": "US",
  "asn_date": "1992-12-01",
  "asn_description": "GOOGLE, US",
  "network": {
    "name": "GOGL",
    "country": "US",
    "start_address": "8.8.8.0",
    "end_address": "8.8.8.255",
    "type": "DIRECT ALLOCATION",
    "status": "active",
    "links": []
  },
  "nir_postal_code": null,
  "nir_range": null,
  "address": "1600 Amphitheatre Parkway",
  "email_admin": "arin-contact@google.com",
  "email_tech": null
}
先に見るレスポンス項目

住所や連絡先の詳細を読む前に、所有権と範囲を説明する項目から確認してください。

  • asn_registry、asn、asn_description は、どのレジストリと運用主体を見ているかを示します。
  • network.start_address、network.end_address、network.status は、その割り当ての見えている範囲とライフサイクルの文脈を示します。
  • address、email_admin、email_tech はエスカレーションのメモには役立ちますが、最初のトリアージシグナルというより補助情報です。
エラー条件

以下は実際のエンドポイントの現在の制約なので、自動化もそれに合わせてください。

  • ip がない場合は {"error": "IP address is required."} が返ります。
  • プライベートまたは予約済みのアドレスは、公開の所有権データではなくエラーJSONを返します。
  • 不正な形式の入力は、IP形式が無効であることを説明するエラーJSONを返します。
APIドキュメントを離れるタイミング

仕様を理解するにはこのドキュメントルートを使い、より豊かな調査コンテキストや共有しやすい検索ページが必要になったら、実際のブラウザワークフローに移ってください。

  • 同じ検索についてブラウザUI、共有URL、地図、調査サマリーが必要な場合は /ip を開いてください。
  • JSON 項目だけでなくワークフローの文脈が必要な場合は、IPとASNガイドを読んでください。
  • 質問がドメイン所有権や CIDR 範囲まで広がったら、ネットワーク/セキュリティハブに戻ってください。
実際の調査ワークフローを続ける
IPとASNガイド
同じ所有権データについてワークフローの解釈が必要な場合は、調査重視のガイドを読んでください。
調査ワークフロー
検索が本格的なトリアージフローに変わったら、より広い ドメイン -> IP -> CIDR の順序に従ってください。
ネットワーク/セキュリティハブ
クイックスタートカードと、より広い調査用の判断ストリップを見るにはハブに戻ってください。
WHOISとRDAPの比較ガイド
実際のIPワークフローが構造化されたレジストリ所有権データを表示する理由を説明する必要がある場合は、プロトコル比較を使ってください。