代理 IP 刷新接口

这个站点提供一个 POST 接口给你的软件调用。每次调用时，服务器都会实时请求上游 API，并返回最新代理 IP。

接口地址

/api.php

请求方式

POST，Content-Type: application/json。仅支持加密协议 v1，不再接受明文表单。

加密协议 v1（概要）

• 请求体与成功响应体均为 JSON：v、app_id、ts、nonce、data、sign
• data 为 AES-256-CBC 密文（IV 前置后 Base64），明文为 UTF-8 JSON 业务参数
• sign = HMAC-SHA256(shared_secret, "v1|app_id|ts|nonce|data") 的十六进制
• 密钥、app_id 与软件内配置保持一致；生产环境务必修改 config.php 中的 shared_secret（或环境变量 XIANYU_PROXY_CRYPTO_SECRET）
• 鉴权失败时 HTTP 400，返回 {"ok":false,"message":"invalid"}（不暴露细节）

业务参数（放在解密后的 JSON 里）

• num：获取数量，1–200，默认由服务端配置
• time、type、so、ow、spl、addr、db：可选覆盖
• 若 config.php 中设置了 access_token，解密后的 JSON 内需带 token 字段

解密后成功响应示例（与旧版字段一致）

{
  "ok": true,
  "message": "",
  "count": 2,
  "proxies": [
    {
      "ip": "1.2.3.4",
      "port": "8080",
      "proxy": "1.2.3.4:8080",
      "location": "xx"
    }
  ],
  "proxy_text": "1.2.3.4:8080",
  "upstream": {}
}