API 参考

快速开始

恢复离线账号

分别检查授权和连接状态。需要授权时继续流程；先了解当前状态，再选择运行态操作。

上手步骤

  1. 1

    获取认证状态

    分别检查授权和连接状态。需要授权时继续流程；先了解当前状态，再选择运行态操作。

    curl -X GET "https://api.unifyport.ai/v1/accounts/{account_id}/auth" \
  -H "X-Api-Key: <YOUR_API_KEY>"
    账号生命周期
  2. 2

    刷新运行时状态

    读取响应的 runtime_status；starting、reconnecting 仍需后续检查。auth_required 为 true 时继续授权；没有该提示也不代表账号在线。

    curl -X POST "https://api.unifyport.ai/v1/accounts/{account_id}/runtime/refresh" \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{}'
    刷新运行时状态
  3. 3

    如何理解结果

    授权需要操作时，继续对应渠道的授权指南。已授权但 stopped 时启动运行态；disconnected 时先刷新状态，仅在渠道支持时重连。恢复发送前再次查询账号，确认 runtime_status 为 running。

    启动运行时