POST /api/v1/forward/channels/{channel_id}/qr_sessions
创建 QR session，用于激活或重新绑定支持扫码授权的 Channel。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
| Idempotency-Key | 否 | 有副作用请求可选的幂等键。 |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| channel_id | string | 是 | Channel ID。 |
请求体
可省略请求体，也可以发送空 JSON 对象 {}。
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| session_key | string | 用于轮询状态的不透明 QR session key。 |
| channel_id | string | 关联的 Channel ID。 |
| channel_type | string | wechat、feishu、dingtalk 或 wecom。 |
| status | string | 初始状态，通常为 waiting。 |
| qr_code_content | string | 二维码原始内容，通常是三方授权 URL。 |
| qr_code_image_base64 | string | 服务端生成的二维码图片。 |
| expires_at | string | 过期时间。 |
错误码
| HTTP | Type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 渠道类型不支持 QR session。 |
| 401 | authentication_error | PAT 或 SAT 无效或已过期。 |
| 404 | not_found_error | Channel 不存在。 |
| 409 | conflict_error | Channel 已停用。 |
| 502 | api_error | 三方渠道授权失败。 |
注意事项
- 当前 QR session 支持
wechat、feishu、dingtalk和wecom。 - 请求体可省略或发送
{}。