查询机 API 文档返回设置返回首页

主站域名与查询机接入

查询机的“主站地址”只填写协议和域名，例如 https://api.example.com。不要填写 /api，程序会自动拼接接口路径。

没有域名

局域网可填写 http://192.168.1.20:8085。公网部署建议使用 HTTPS 域名，不要直接暴露 8085。

有域名

把域名解析到主站 IP，用 Nginx/Caddy 将 HTTPS 反向代理到 127.0.0.1:8085。之后所有查询机都填写同一个域名。

server {
    listen 443 ssl;
    server_name api.example.com;

    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 120s;
    }
}

鉴权

在主站“设置 → 操作与安全”复制查询机 Token。查询机接口统一发送请求头：

X-Worker-Token: 主站生成的Token
Content-Type: application/json

主站管理页面的 Bearer 登录 Token 和查询机 Token 是两套独立凭据。

接口列表

方法与路径用途重要参数
GET /api/next-keyword领取 1–10 个带租约的词worker_id、browser_id、platform、count
POST /api/submit-result提交订单或错误并释放租约worker_id、platform、keyword、orders
POST /api/worker-heartbeat报告在线并续租正在查询的词worker_id、platform、keywords
POST /api/worker-release查询机停止时立即交回未完成词worker_id，可选 platform/keywords
POST /api/worker-log将查询日志汇总到主站worker_id、browser_id、level、event

领取示例

GET https://api.example.com/api/next-keyword
    ?worker_id=worker-a
    &browser_id=0
    &platform=ldxp
    &count=1

响应：
{
  "state": "claimed",
  "keywords": [{"keyword": "测试词", "days": 30}]
}

新词查询 30 天，热词查询 2 天。查询机断线且租约到期后，词会自动分给其他查询机。