U
RESTful API

API 文档中心

开放的 RESTful API 接口，轻松集成到您的业务系统

免费版
¥0/月
  • 1,000 积分/月
  • 5 QPS
  • 基础接口
  • 注册即送 100 积分
专业版
推荐
¥99/月
  • 50,000 积分/月
  • 20 QPS
  • 全部接口
  • 优先工单支持
企业版
¥999/月
  • 不限调用次数
  • 不限 QPS
  • 全部接口
  • 专属技术支持
  • 定制开发
认证与积分

本站采用 Cookie 会话认证。调用需要登录的接口前，请先调用 /api/auth/login 完成登录，后续请求携带 Cookie 即可。

已登录用户每次调用工具接口会扣除 1 积分；未登录用户可免费使用但受浏览器速率限制。企业版用户不扣除积分。

可通过 /api/payment/create-order 创建 VIP 或积分充值订单，再调用支付回调完成购买。生产环境请将 /api/payment/mock-pay 替换为支付宝/微信等真实支付渠道回调。

积分不足时会返回 HTTP 403，提示充值或升级 VIP。

接口列表

GET/api/ip-info

获取当前访问 IP 的地理位置信息

POST/api/auth/register

用户注册，注册成功后自动登录并设置 Cookie

Body: { "email": "user@example.com", "password": "123456" }
POST/api/auth/login

用户登录，成功后设置 httpOnly Cookie

Body: { "email": "user@example.com", "password": "123456" }
GET/api/auth/me需登录

获取当前登录用户信息

POST/api/ip需登录

查询指定 IP 或域名的归属地信息

Body: { "target": "baidu.com" }
POST/api/ping需登录

对目标域名或 IP 执行 Ping 测试

Body: { "target": "baidu.com" }
POST/api/dns需登录

查询域名的 DNS 解析记录

Body: { "domain": "baidu.com", "type": "A" }
POST/api/ssl需登录

检测域名的 SSL 证书信息

Body: { "domain": "baidu.com" }
POST/api/whois需登录

查询域名的 Whois 注册信息

Body: { "domain": "baidu.com" }
POST/api/speed需登录

测试网页加载性能，返回 DNS、连接、首字节、下载耗时

Body: { "target": "baidu.com" }
POST/api/http需登录

检测网站 HTTP 状态码、响应头、跳转链和响应体预览

Body: { "target": "baidu.com" }
POST/api/icp需登录

查询域名 ICP 备案信息

Body: { "domain": "baidu.com" }
POST/api/traceroute需登录

追踪数据包到目标地址经过的路由节点

Body: { "target": "baidu.com" }
POST/api/payment/create-order需登录

创建 VIP 或积分充值订单

Body: { "type": "vip", "planId": "pro" }
POST/api/payment/mock-pay需登录

模拟支付回调，完成订单并更新账户（生产环境替换为真实支付回调）

Body: { "orderId": "..." }
GET/api/user/orders需登录

获取当前登录用户的订单记录

调用示例

1. 登录获取会话
curl -X POST https://ipcesu.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"123456"}' \
  -c cookie.txt
2. 调用工具接口
curl -X POST https://ipcesu.com/api/ip \
  -H "Content-Type: application/json" \
  -b cookie.txt \
  -d '{"target": "baidu.com"}'