按筛选条件分页列出 Forward Session。
HTTP 200 OK
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT> |
查询参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
identity_ids | string或array | 否 | - | 按一个或多个 Identity ID 过滤,支持逗号分隔。 |
template_id | string | 否 | - | 按 Forward Template ID 过滤。 |
source_type | string | 否 | - | 按 api、im 或 schedule 过滤。 |
created_at[gt] | string | 否 | - | 创建时间严格大于该 RFC 3339 时间。 |
created_at[gte] | string | 否 | - | 创建时间大于等于该 RFC 3339 时间。 |
created_at[lt] | string | 否 | - | 创建时间严格小于该 RFC 3339 时间。 |
created_at[lte] | string | 否 | - | 创建时间小于等于该 RFC 3339 时间。 |
updated_at[gt] | string | 否 | - | 更新时间严格大于该 RFC 3339 时间。 |
updated_at[gte] | string | 否 | - | 更新时间大于等于该 RFC 3339 时间。 |
updated_at[lt] | string | 否 | - | 更新时间严格小于该 RFC 3339 时间。 |
updated_at[lte] | string | 否 | - | 更新时间小于等于该 RFC 3339 时间。 |
limit | integer | 否 | 20 | 分页大小,最大 100。 |
after_id | string | 否 | - | 向后翻页游标。 |
before_id | string | 否 | - | 向前翻页游标。 |
order | string | 否 | desc | 排序方向:desc 或 asc。 |
include_archived | boolean | 否 | false | 是否包含已归档 Session。 |
示例请求
示例响应
HTTP 200 OK
响应字段
字段 | 类型 | 说明 |
| array | 当前页的 Session 对象。 |
| string|null | 当前页第一条记录 ID。 |
| string|null | 当前页最后一条记录 ID。 |
| boolean | 是否还有更多记录。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 400 | invalid_request_error | invalid_time_range | 时间筛选范围不合法。 |
| 400 | invalid_request_error | invalid_pagination | 分页参数不合法。 |
| 401 | - | TOKEN_INVALID | PAT 无效或已过期。 |
备注
after_id和before_id不能同时传入。- 当前设计不支持按
status筛选。 - Credits 模块未启用时可省略
usage.credits。