Skip to main content
Channels

获取 Channel 配对

查询一条未绑定或已绑定的 Channel 配对记录。

Channel 配对目前为 Beta 功能,接口定义、响应结构和行为可能调整,请关注文档更新。
GET /api/v1/forward/channel_pairings/{pairing_id} 查询一条未绑定或已绑定的配对记录。

请求参数

使用 Authorization: Bearer <PAT 或 SAT>。路径参数 pairing_id配对列表返回的 id

示例请求

curl -s 'https://api.qoder.com/api/v1/forward/channel_pairings/pair_019eabc123' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK
{
  "id": "pair_019eabc123",
  "type": "channel_pairing",
  "channel_id": "channel_019eabc123",
  "scope_type": "direct",
  "scope_external_id": "external_user_id",
  "scope_display_name": "测试用户",
  "status": "active",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_workspace_dev",
  "paired_at": "2026-09-09T08:00:00Z",
  "created_at": "2026-09-09T07:50:00Z",
  "updated_at": "2026-09-09T08:00:00Z"
}
scope_typedirect(私聊)或 room(群聊),scope_external_id 为对应的外部用户或群 ID。 未绑定时 status=pairingidentity_idtemplate_idpaired_at 为空字符串。配对码过期不改变此状态;接口不返回配对码。 记录不存在、已解绑或无权访问时返回 404;凭证无效时返回 401。 scope_display_name 为用户昵称或群名,未获取到时为空字符串;随后续消息更新,仅供展示,授权请使用外部 ID。

相关接口