Skip to content

分页读取填写记录的后续动态 ​

分页读取一条填写记录提交之后的动态(回复、处理进度变化等),只读,不会标记已读。access 为 denied 表示当前凭证无权读取动态,不代表没有动态。

请求 ​

text
POST https://open.cli.im/api/v2/rpc/record/getActivities
项目要求
最低权限只读,见权限档位
需要的 scoperecords.read
组织 Key不能调用,返回 403 credential_type_not_allowed,见历史组织 Key

相关调用流程:查询二维码关联表单和记录、向指定二维码下的表单提交记录。

请求参数 ​

请求体为 JSON。

字段类型必填说明
record_idstring否记录 ID,与 record_url 恰选其一。最长 19 个字符
record_urlstring否记录链接,与 record_id 恰选其一。最长 2048 个字符
pageinteger否页码,从 1 开始。默认 1。范围 1–1000
page_sizeinteger否每页条数。默认 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_idany是记录 ID
data.accessstring是full 可以读取动态;denied 当前凭证无权读取动态,此时 items 为空,不代表没有动态。可选值:full、denied
data.itemsobject[]是动态列表,按发生顺序
data.items[].activity_idany是动态 ID
data.items[].typestring是动态类型;无法归类的为 other
data.items[].created_atinteger是发生时间(Unix 秒)
data.items[].actorobject否操作人
data.items[].actor.namestring否姓名
data.items[].contentany否动态内容:文本、图片、文件、音视频或签名
data.items[].progressobject否处理进度变化
data.items[].progress.beforeany否变化前
data.items[].progress.afterany否变化后
data.items[].relatedany否关联的填表或回复,只给出引用
data.pageobject是分页信息
data.page.numberinteger是当前页码
data.page.sizeinteger是每页条数
data.page.totalinteger是总条数;access 为 denied 时为 null
data.page.has_moreboolean是是否还有下一页

响应示例 ​

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 生成。全部接口见接口清单。