分页读取填写记录的后续动态
分页读取一条填写记录提交之后的动态(回复、处理进度变化等),只读,不会标记已读。access 为 denied 表示当前凭证无权读取动态,不代表没有动态。
请求
text
POST https://open.cli.im/api/v2/rpc/record/getActivities| 项目 | 要求 |
|---|---|
| 最低权限 | 只读,见权限档位 |
| 需要的 scope | records.read |
| 组织 Key | 不能调用,返回 403 credential_type_not_allowed,见历史组织 Key |
相关调用流程:查询二维码关联表单和记录、向指定二维码下的表单提交记录。
请求参数
请求体为 JSON。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
record_id | string | 否 | 记录 ID,与 record_url 恰选其一。最长 19 个字符 |
record_url | string | 否 | 记录链接,与 record_id 恰选其一。最长 2048 个字符 |
page | integer | 否 | 页码,从 1 开始。默认 1。范围 1–1000 |
page_size | integer | 否 | 每页条数。默认 20。范围 1–50 |
请求示例
示例里的 ID、幂等键等换成实际值。
bash
curl -sS -X POST 'https://open.cli.im/api/v2/rpc/record/getActivities' \
-H "Authorization: Bearer ${CAOLIAO_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"record_id": "2644272",
"page": 1,
"page_size": 20
}'响应
成功时 HTTP 状态码为 200,顶层 code 为 0,结果在 data 里。失败时的返回见错误码与调用额度和业务错误码。
| 字段 | 类型 | 一定返回 | 说明 |
|---|---|---|---|
data.record_id | any | 是 | 记录 ID |
data.access | string | 是 | full 可以读取动态;denied 当前凭证无权读取动态,此时 items 为空,不代表没有动态。可选值:full、denied |
data.items | object[] | 是 | 动态列表,按发生顺序 |
data.items[].activity_id | any | 是 | 动态 ID |
data.items[].type | string | 是 | 动态类型;无法归类的为 other |
data.items[].created_at | integer | 是 | 发生时间(Unix 秒) |
data.items[].actor | object | 否 | 操作人 |
data.items[].actor.name | string | 否 | 姓名 |
data.items[].content | any | 否 | 动态内容:文本、图片、文件、音视频或签名 |
data.items[].progress | object | 否 | 处理进度变化 |
data.items[].progress.before | any | 否 | 变化前 |
data.items[].progress.after | any | 否 | 变化后 |
data.items[].related | any | 否 | 关联的填表或回复,只给出引用 |
data.page | object | 是 | 分页信息 |
data.page.number | integer | 是 | 当前页码 |
data.page.size | integer | 是 | 每页条数 |
data.page.total | integer | 是 | 总条数;access 为 denied 时为 null |
data.page.has_more | boolean | 是 | 是否还有下一页 |
响应示例
json
{
"code": 0,
"message": "ok",
"data": {
"record_id": "2644272",
"access": "full",
"items": [
{
"activity_id": "88120",
"type": "reply",
"created_at": 1794992400,
"actor": {
"name": "李四"
},
"content": {
"text": "已安排维修。"
}
}
],
"page": {
"number": 1,
"size": 20,
"total": 1,
"has_more": false
}
}
}本页由 openapi.json 生成。全部接口见接口清单。