EasyRouterEasyRouter
使用指南API 文档接入 Agent 工具
管理接口真人认证与素材管理

获取真人认证结果并查询 GroupId

GET
/api/resource-channel/byteplus/visual-validate/sessions/{session_id}

Authorization

BearerAuth

AuthorizationBearer <token>

API Key (sk-xxxxxx)

In: header

Path Parameters

session_id*string

创建真人认证会话后返回的会话 ID，用户通过 h5_link 完成人脸识别后可获取

⚠️ 重要提示 session_id 改变 创建会话后，用户需要通过返回的 h5_link 处理真人认证流程，认证完成后方可获取 session_id。

Query Parameters

result_code?string

终端解析 callback URL 后拿到的结果码；10000 代表认证成功

Response Body

application/json

curl -X GET "https://easyrouter.io/api/resource-channel/byteplus/visual-validate/sessions/string"
{
  "success": true,
  "message": "",
  "data": {
    "session_id": "20260520163328CC8B02B43817D1796643",
    "byted_token": "20260520163328CC8B02B43817D1796643",
    "group_id": "group-20260520163350-ctpqc",
    "channel_id": 21,
    "status": "verified",
    "result_code": "10000",
    "raw_response": "{\"ResponseMetadata\":{\"Action\":\"GetVisualValidateResult\",\"Region\":\"ap-southeast-1\",\"RequestId\":\"20260520164012E231B41B7575F3AB6642\",\"Service\":\"ark\",\"Version\":\"2024-01-01\"},\"Result\":{\"GroupId\":\"group-20260520163350-ctpqc\"}}",
    "created_at": "2026-05-20T16:33:28+08:00",
    "updated_at": "2026-05-20T16:40:12.298074+08:00"
  }
}