工作表记录
获取行记录讨论
根据鉴权方式查看“获取行记录讨论”对应的真实 API 地址、参数与响应。
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
worksheet_id | string | 是 | 工作表ID |
row_id | string | 是 | 行记录ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Query 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
pageIndex | integer | 否 | 页码 |
pageSize | integer | 否 | 每页大小 |
search | string | 否 | 搜索关键词 |
onlyWithAttachments | boolean | 否 | 是否只返回包含附件的讨论 |
responseFormat | string | 否 | 响应格式：json - 返回 JSON，md - 返回 Markdown 文本(更省 token，仅返回部分重要字段) 可选值： "json""md" |
响应参数
200成功获取讨论列表| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | 讨论列表查询结果 |
data.discussions | object[] | 讨论列表 |
data.discussions.id | string | 讨论 id |
data.discussions.message | string | 讨论内容 |
data.discussions._createdAt | string | 创建时间 |
data.discussions._createdBy | object | 创建人信息 |
data.discussions._createdBy.id | string | 人员 id |
data.discussions._createdBy.name | string | 名称 |
data.discussions._createdBy.avatar | string | 头像地址 |
data.discussions._createdBy.isPortal | boolean | 是否为门户用户 |
data.discussions._createdBy.status | integer | 状态 |
data.discussions._createdBy.accountId | string | 人员 id (兼容字段) |
data.discussions._createdBy.fullname | string | 名称 (兼容字段) |
data.discussions.replyToAuthor | object | 被回复的作者信息 |
data.discussions.replyToAuthor.id | string | 人员 id |
data.discussions.replyToAuthor.name | string | 名称 |
data.discussions.replyToAuthor.avatar | string | 头像地址 |
data.discussions.replyToAuthor.isPortal | boolean | 是否为门户用户 |
data.discussions.replyToAuthor.status | integer | 状态 |
data.discussions.replyToAuthor.accountId | string | 人员 id (兼容字段) |
data.discussions.replyToAuthor.fullname | string | 名称 (兼容字段) |
data.discussions.replyToId | string[] | 被回复的讨论 id 列表 |
data.discussions.mentions | object[] | 提及的用户列表 |
data.discussions.mentions.id | string | 人员 id |
data.discussions.mentions.name | string | 名称 |
data.discussions.mentions.avatar | string | 头像地址 |
data.discussions.mentions.isPortal | boolean | 是否为门户用户 |
data.discussions.mentions.status | integer | 状态 |
data.discussions.mentions.accountId | string | 人员 id (兼容字段) |
data.discussions.mentions.fullname | string | 名称 (兼容字段) |
data.discussions.attachments | object[] | 附件信息 |
data.discussions.attachments.originalFilename | string | 文件名称 |
data.discussions.attachments.ext | string | 文件类型 |
data.discussions.attachments.filesize | string | 文件大小 |
data.discussions.attachments.downloadUrl | string | 下载地址 |
curl -X GET "https://example.com/v3/app/worksheets/worksheet_id/rows/row_id/discussions?responseFormat=json" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}"{ "data": { "discussions": [ { "id": "187f3fd4-411d-42fe-8bd0-2af79d35807b", "message": "？", "_createdAt": "2025-07-15 22:28:21", "_createdBy": { "id": "e2453de8-1a6a-4d4f-ba36-87fdff880a20", "name": "Alice", "avatar": "https://dn-mdpic.example.com/UserAvatar/fUdk9QeS4D2QcJ3edmfrdP6ydYadd4fy8ZdDaJbNdr8Sdq151MbW7oeZ8ld7194Z.png?imageView2/1/w/48/h/48/q/90", "isPortal": false, "status": 1 }, "replyToAuthor": { "id": "e2453de8-1a6a-4d4f-ba36-87fdff880a20", "name": "Alice", "avatar": "https://dn-mdpic.example.com/UserAvatar/fUdk9QeS4D2QcJ3edmfrdP6ydYadd4fy8ZdDaJbNdr8Sdq151MbW7oeZ8ld7194Z.png?imageView2/1/w/48/h/48/q/90", "isPortal": false, "status": 1 }, "replyId": "fbf1ff76-5a4a-49b5-b51f-e879d058142d", "projectId": "fe288386-3d26-4eab-b5d2-51eeab82a7f9", "replyToId": [], "mentions": [], "attachments": [ { "originalFilename": "文件名称", "ext": "文件类型", "filesize": "文件大小", "downloadUrl": "下载地址" } ] } ] }, "success": true}