帮助文档
快速上手与常见问题,未完待续,敬请期待。
GET /
描述:返回客户端 IP 与地理位置。
示例:
curl 3.0.2.9
返回(JSON):
{"ip":"...","location":"...","xad":"..."}
GET /ip
描述:返回客户端 IP 与地理位置。
示例:
curl 3.0.2.9/ip
返回(JSON):
{"ip":"...","location":"...","xad":"..."}
GET /ip/1.1.1.1
描述:查询指定 IP/域名 的地理信息。
要求:当查询“域名”时,必须使用 HTTPS(HTTP 将返回 426 Upgrade Required)。
示例(查询 IP):
curl 3.0.2.9/ip/1.1.1.1
示例(查询域名,需 HTTPS):
curl https://3.0.2.9/ip/example.com
返回(JSON,IP 示例):
{"ip":"1.1.1.1","location":"...","xad":"..."}
GET /iq
描述:查询 IP 或域名的地理位置、ASN、网络身份、风险信号与适用场景。
浏览器:
3.0.2.9/iq?ip=8.8.8.8
JSON:
curl "3.0.2.9/iq?ip=8.8.8.8&format=json"
路径参数同样可用:
curl 3.0.2.9/iq/1.1.1.1
返回(JSON):
{"ip":"8.8.8.8","risk_score":32,"risk_level":"中性","confidence":90,
"geo":{...},"network":{...},"classification":{...},
"signals":[...],"scenarios":[...],"methodology_version":"..."}
GET /ips
描述:查询当前客户端 IP 的详细归属信息。
示例:
curl 3.0.2.9/ips
返回(JSON):
{"ip":"...","country":"...","region":"...","city":"...","asn":"...","timezone":"...","xad":"..."}
GET /ua
描述:返回客户端 User-Agent。
示例:
curl 3.0.2.9/ua
返回(JSON):
{"ua":"curl/8.0.1","xad":"..."}
GET /header
描述:回显客户端请求头部字段。
示例:
curl -H 'X-FOO: bar' 3.0.2.9/header
返回(JSON):
{"X-Foo":"bar","User-Agent":"curl/8.0.1","xad":"..."}
POST /image
描述:上传文件至中转站,成功后返回公开下载链接。
鉴权:资源被滥用,需有效口令
购买:https://my.cloudcpp.com/buy/21
示例:
curl -H "X-K: <口令>" -F "f=@1.png" 3.0.2.9/image
返回(JSON):
{"1.png":"https://<绑定域>/cache/<taskid>.png", "xad":"..."}
POST /burn
描述:创建一次性链接,内容首次查看即销毁。
要求:必须使用 HTTPS(HTTP 将返回 426 Upgrade Required)。
请求(表单):
content=文本内容
ttl=过期秒数(可选,默认 24 小时)
示例:
curl -X POST 3.0.2.9/burn \
-d 'content=一次性内容' \
-d 'ttl=600'
返回(JSON 触发条件:?format=json 或 Accept: application/json 或 curl/wget UA):
{"id":"...","link":"3.0.2.9/burn/...","xad":"..."}