/api/ip 的 IP 查詢 API 指南

使用本指南向 /api/ip 傳送單個 IP 查詢請求,瞭解返回的 JSON 欄位,並在需要更多上下文時轉到即時瀏覽器工作流。

/api/ip 每次請求處理一個公網 IP。沒有批次介面、沒有身份驗證,也不提供可用性保證。

適用場景
您需要單個公網 IP 查詢的 JSON 輸出,並且在自動化 fetch 或 CLI 呼叫前需要準確的請求模式。
當前介面約定
/api/ip 需要 ip 查詢引數,並且每次為一個公網 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 示例
當您需要 JSON 而不是純文字的 /ip 終端快捷方式時,請顯式傳遞 ip 查詢引數。
curl https://comutil.com/api/ip?ip=8.8.8.8
響應欄位示例
即時端點會返回頂層 ASN 元資料,以及一個來自當前 RDAP 和 WHOIS 查詢流程的巢狀 network 物件。
{
  "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": "[email protected]",
  "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 文件頁面

先透過文件路由瞭解介面約定,然後在需要更豐富的調查上下文或可分享的查詢頁面時轉到即時瀏覽器工作流。

  • 當您需要瀏覽器介面、分享 URL、地圖和圍繞同一次查詢的調查摘要時,請開啟 /ip。
  • 當您需要工作流層面的說明而不只是 JSON 欄位時,請閱讀 IP 和 ASN 指南。
  • 當問題擴充套件到域名所有權或 CIDR 範圍時,請返回網路/安全中心。