跳转到主要内容
GET /api/v1/forward/identities/{identity_id}/templates 返回该 Identity 下 active 或 archived 的 Identity Config 记录。

​
请求头

Header是否必填说明
Authorization是Bearer <PAT>

​
路径参数

参数类型是否必填说明
identity_idstring是Forward Identity ID。

​
查询参数

参数类型是否必填默认值说明
template_idstring否-按 Forward Template ID 过滤。
statusstring否active按 active 或 archived 过滤。
limitinteger否20分页大小，最大 100。
after_idstring否-来自上一页响应 last_id 的向后游标。
before_idstring否-来自上一页响应 first_id 的向前游标。

​
示例请求

curl -s -X GET 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123/templates' \
  -H "Authorization: Bearer $QODER_PAT"

​
示例响应

HTTP 200 OK 
{
  "data": [
    {
      "type": "config",
      "id": "cfg_support",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "name": "CRM profile",
      "status": "active",
      "effective_hash": "sha256:...",
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "cfg_support",
  "last_id": "cfg_support",
  "has_more": false
}

​
响应字段

字段类型说明
dataarray当前页的 Config 摘要。
first_idstring | null当前页第一条 Config ID。
last_idstring | null当前页最后一条 Config ID。
has_moreboolean是否还有更多记录。

​
错误

HTTPTypeCode触发条件
400invalid_request_error-分页参数不合法。
404not_found_error-Identity 不存在或当前调用方不可见。
401authentication_errorauthentication_requiredPAT 无效或已过期。

​
注意事项

  • 分页游标来自 Identity Config ID，不是 Template ID。
  • 同一个 Identity + Template 下最多只有一条 active Config。

​
相关

创建或更新 Identity Config

获取 Effective Config