帮助文档

快速上手与常见问题，未完待续，敬请期待。

GET /

描述：返回客户端 IP 与地理位置。

示例：
    curl api.cloudcpp.com

返回（JSON）：
    {"ip":"...","location":"...","xad":"..."}

GET /ip

描述：返回客户端 IP 与地理位置。

示例：
    curl api.cloudcpp.com/ip

返回（JSON）：
    {"ip":"...","location":"...","xad":"..."}

GET /ip/1.1.1.1

描述：查询指定 IP/域名 的地理信息。
要求：当查询“域名”时，必须使用 HTTPS（HTTP 将返回 426 Upgrade Required）。

示例（查询 IP）：
    curl api.cloudcpp.com/ip/1.1.1.1
示例（查询域名，需 HTTPS）：
    curl https://api.cloudcpp.com/ip/example.com

返回（JSON，IP 示例）：
    {"ip":"1.1.1.1","location":"...","xad":"..."}

GET /iq

描述：查询 IP 或域名的地理位置、ASN、网络身份、风险信号与适用场景。

浏览器：
    api.cloudcpp.com/iq?ip=8.8.8.8

JSON：
    curl "api.cloudcpp.com/iq?ip=8.8.8.8&format=json"

路径参数同样可用：
    curl api.cloudcpp.com/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 api.cloudcpp.com/ips

返回（JSON）：
    {"ip":"...","country":"...","region":"...","city":"...","asn":"...","timezone":"...","xad":"..."}

GET /ua

描述：返回客户端 User-Agent。

示例：
    curl api.cloudcpp.com/ua

返回（JSON）：
    {"ua":"curl/8.0.1","xad":"..."}

GET /header

描述：回显客户端请求头部字段。

示例：
    curl -H 'X-FOO: bar' api.cloudcpp.com/header

返回（JSON）：
    {"X-Foo":"bar","User-Agent":"curl/8.0.1","xad":"..."}

POST /pic/compress

描述：压缩或转换 JPG、PNG、WebP、HEIC 图片，处理完成后直接返回图片，不生成公开链接。

限制：API 每次只接收 1 张图片，单张最大 10MB；单边不超过 24000 像素，总像素不超过 4000 万，不支持动图。浏览器 /pic 每批最多 5 张、总计不超过 50 MB。

限流：同一 IP 在所有 API 节点共享每小时 60 次压缩请求额度，请求进入接口即计数。达到限制返回 HTTP 429；中间件不可用时返回 HTTP 503。

请求（multipart/form-data）：
    file=图片文件
    mode=quality|balanced|compact（可选，默认 balanced）
    format=original|jpg|png|webp|heic（可选，默认 original）

示例：
    curl -F "mode=balanced" -F "format=webp" \
        -F "file=@photo.png" api.cloudcpp.com/pic/compress \
        -o photo-compressed.webp

POST /image

描述：上传文件至中转站，成功后返回公开下载链接。

免费：无需口令；单文件最大 32MB，最多 5 个，保留 1 小时；全站每日共享 5GiB 上传与下载总额度，上传和下载合并计算。用完后暂停免费上传及免费文件的新下载。

口令：请求头 X-K；单文件最大 512MB，最多 5 个，保留 24 小时；每个口令独立享有每日 5GiB 总传输额度，上传与下载合并计算，且不占用免费用户的全站额度；下载链接无需口令。

购买：https://my.cloudcpp.com/buy/21

示例：
    curl -F "f=@1.png" api.cloudcpp.com/image
    curl -H "X-K: <口令>" -F "f=@1.png" api.cloudcpp.com/image
    curl -F "f=@1.png" "api.cloudcpp.com/image?k=<口令>"

返回（JSON）：
    {
      "files": [
        {
          "id": "<Snowflake ID>",
          "name": "1.png",
          "url": "https://<绑定域>/cache/<Snowflake ID>.png",
          "status": "ok"
        }
      ],
      "xad": "..."
    }

POST /burn

描述：创建一次性链接，内容首次查看即销毁。
要求：必须使用 HTTPS（HTTP 将返回 426 Upgrade Required）。

请求（表单）：
    content=文本内容
    ttl=过期秒数（可选，默认 24 小时）

示例：
    curl -X POST api.cloudcpp.com/burn \
        -d 'content=一次性内容' \
        -d 'ttl=600'

 返回（JSON 触发条件：?format=json 或 Accept: application/json 或 curl/wget UA）：
    {"id":"...","link":"api.cloudcpp.com/burn/...","xad":"..."}

更多