IP信息查询

查询单个 IPv4/IPv6 的基础属性、路由前缀/ASN 和 RIR 公网注册摘要。公网数据来自 RIPEstat Network Info 与 RIR RDAP；country_code 是注册记录国家/地区代码，不代表设备实时物理位置，也不提供未经授权的城市级定位。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类数据查询

调用费用免费

包月要求不强制包月

调用限制30 次/分钟

补充说明

POST JSON /api/v1/endpoints/ip-info，Bearer API Key。参数仅 ip；公网地址查询 RIPEstat Network Info 与 RIR RDAP，私网/环回/保留地址只做本地分类。详细字段和限制参见前台接口文档及 docs/API.md。

请求参数

除 Bearer API Key 请求头外，使用 application/json 发送以下字段。图片接口的文件需先转成纯 Base64 字符串提交。

字段名称	格式	说明
`ip`	字符串	必填，单个 IPv4 或 IPv6；私网/环回/保留地址只返回本地分类，不发送第三方；公网两类数据源支持单源降级

非预期参数将被忽略；非法参数 HTTP 422。接口执行异常统一返回失败响应，不计为成功扣点。请仅提交您有权处理的文本、图片或网页内容。

示例代码

将密钥和业务字段替换为自己的实际值，不要在公开网页或 App 内写入管理员密钥。

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/ip-info" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/ip-info', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({"ip":"8.8.8.8"})
}).then(r => r.json()).then(console.log);

响应结构

{
  "code": 0,
  "msg": "处理成功",
  "platform": "ip-info",
  "data": {
    "ip": "8.8.8.8",
    "version": "IPv4",
    "scope": "public",
    "is_public": true,
    "summary": {"status":"complete","asn":"AS15169","prefix":"8.8.8.0/24","network_name":"GOGL","organization":"Google LLC","country_code":"US","registry":"ARIN"},
    "routing": {"available":true,"asn":"AS15169","asns":["AS15169"],"prefix":"8.8.8.0/24","source":"RIPEstat Network Info"},
    "registration": {"available":true,"registry":"ARIN","country_code":"US","organization":"Google LLC","source":"RIR RDAP"}
  }
}

示例网络名称、前缀和组织仅用于展示字段结构，以实时公开注册/路由数据为准。country_code 是 RIR 注册记录中的国家/地区代码，不等同于设备当前城市或精确地理位置；本接口不使用未经授权的城市级商业 GeoIP 数据。公网查询的 summary.status 为 complete / partial，任一公开数据源暂时异常时仍返回另一来源的可用字段。私网、环回、链路本地、共享地址、组播及保留地址只返回本地分类，不发送给外部数据服务。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.ip`	字符串	查询的 IP 地址。
`data.version`	字符串	IPv4 或 IPv6。
`data.scope`	字符串	地址范围分类，例如 public、private、loopback 等。
`data.is_public`	布尔值	是否为公网地址。
`data.summary`	对象	公网 IP 的 ASN、前缀、网络名称、组织、国家代码和注册机构摘要。
`data.routing`	对象	RIPEstat 路由 ASN/前缀结果。
`data.registration`	对象	RIR RDAP 公网注册信息。
`data.checked_at`	字符串	查询时间。

无效参数 HTTP 422；无效密钥 401；权限限制 403；点数不足 402；频率超限 429；服务暂不可用 503。

在线测试 · IP信息查询

请填写自己的 API Key。图片只上传到当前 API 请求，不保存到浏览器本地存储；图片 Base64 在下方结果中自动隐藏。

响应结果

填写参数后点击“发送测试请求”。