跳到主要内容

curl 示例

curl 示例​

将占位符替换为客户端中复制的访问密钥和资源标识后再执行。

服务健康状态​

curl http://127.0.0.1:45536/health

团队列表​

先取到 data[].id，它就是其他接口需要的 teamId。

curl -H "Authorization: Bearer <API_KEY>" http://127.0.0.1:45536/team/list

窗口列表​

窗口 ID 取 data.data[].id；runtimeState 为 local_running 表示窗口正在本机运行，occupied_by_other 表示被其他用户占用。

curl "http://127.0.0.1:45536/browser/list?page=1&size=20" \
  -H "Authorization: Bearer <API_KEY>"

按状态筛选代理​

数组参数用重复传参表达，下面等价于「来源为购买且状态为可用或待检测」。

curl -H "Authorization: Bearer <API_KEY>" \
  "http://127.0.0.1:45536/proxy/list?source=BUY&state=1&state=0&page=1&size=20"

批量检测代理​

在客户端本机检测已保存的代理，结果会写回代理记录；单次最多 50 个。

curl -X POST http://127.0.0.1:45536/proxy/detect \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"proxyIds":[6001,6002]}'

打开窗口并读取 CDP 连接​

curl -X POST http://127.0.0.1:45536/browser/open \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"teamId":"<TEAM_ID>","ids":["<WINDOW_ID>"]}'

curl -H "Authorization: Bearer <API_KEY>" \
  "http://127.0.0.1:45536/browser/connection_info?windowId=<WINDOW_ID>"

自动化最小闭环​

创建会话 → 打开标签页 → 执行动作 → 释放会话。四次调用都要带同一个 X-Nex-Client-Id。

# 1. 创建会话，返回 data.sessionId
curl -X POST http://127.0.0.1:45536/automation/sessions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-Nex-Client-Id: nex-doc-client-01" \
  -H "Content-Type: application/json" \
  -d '{"teamId":"<TEAM_ID>","windowId":"<WINDOW_ID>","startIfNeeded":true}'

# 2. 打开标签页，返回 data[].pageId
curl -X POST http://127.0.0.1:45536/automation/sessions/<SESSION_ID>/tabs \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-Nex-Client-Id: nex-doc-client-01" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

# 3. 执行白名单动作
curl -X POST http://127.0.0.1:45536/automation/sessions/<SESSION_ID>/actions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-Nex-Client-Id: nex-doc-client-01" \
  -H "Content-Type: application/json" \
  -d '{"action":"click","params":{"target":"a","timeout":5000}}'

# 4. 释放当前客户端的全部会话（不关闭浏览器窗口）
curl -X DELETE http://127.0.0.1:45536/automation/sessions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-Nex-Client-Id: nex-doc-client-01"

购买手机号并读取验证码​

选定任务需要的国家、项目和数量后直接购买，由服务端校验库存并按当前价格扣费。项目查询用于选择业务参数，不是购买前的报价或库存预检。

# 1. 查询国家下的项目、单价与库存
curl -H "Authorization: Bearer <API_KEY>" \
  "http://127.0.0.1:45536/sms/stocks?countryId=1"

# 2. 直接购买 1 个号码并按服务端当前价格扣费
curl -X POST http://127.0.0.1:45536/sms/buy \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"countryId":1,"projectId":1001,"quantity":1}'

# 3. 查已购号码，取 data.data[].tel
curl -H "Authorization: Bearer <API_KEY>" \
  "http://127.0.0.1:45536/sms/records?page=1&size=20"

# 4. 拉取短信，验证码在 data.message 解析后的 code
curl -X POST http://127.0.0.1:45536/sms/pull \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"tel":"<TEL>"}'