跳到主要内容

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；opened 为 ON 表示窗口已经打开。

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"

打开窗口并读取 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"