GET 查询工作汇报详情
GET 查询详情。query 参数:id(必填)。返回汇报内容、工作项、评论、审批流程及规则板块;仅数据权限范围内提交人的汇报可查看。
| 接口编码 | 所需范围 | 后端接口 |
|---|---|---|
office.work-report.detail | office:read | GET /v1/work-reports/detail(comap-office) |
请求参数(query)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer(int64) | 是 | — |
「必填」仅反映接口规格声明的部分。服务内还有未体现在规格里的校验, 标「—」不等于可以不传;租户在主站配置的字段必填不约束本接口。 详见必填字段的判定与字段清单与自定义字段。
请求示例
curl -X POST https://open.risemap.cn/v1/api/invoke \
-H "Authorization: Bearer <访问令牌>" \
-H "Content-Type: application/json" \
-d '{
"apiCode": "office.work-report.detail",
"query": {
"id": "1961000000000000001"
}
}'
响应 data 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | — | 汇报ID |
title | string | — | 汇报标题 |
type | string | — | 汇报类型:DAILY-日报、WEEKLY-周报、MONTHLY-月报、PROJECT-项目汇报、SPECIAL-专项汇报 |
ruleId | string | — | 关联规则ID |
ruleName | string | — | 规则名称 |
period | string | — | 展示周期 |
periodStart | string(date-time) | — | 周期开始日期 |
periodEnd | string(date-time) | — | 周期结束日期 |
submitterId | string | — | 提交人ID |
submitterName | string | — | 提交人姓名 |
deptId | string | — | 提交人部门ID |
flowInstanceCode | string | — | 流程实例编码 |
status | integer(int32) | — | 状态:0-草稿、1-待审批、3-已通过、4-已驳回、5-已撤回 |
score | number | — | 审批人评分 |
approvalScore | number | — | 审批评分(管理者评分) |
selfScore | number | — | 自评分 |
weekSummary | string | — | 本周工作总结 |
nextWeekPlan | string | — | 下周工作计划 |
projectProgress | string | — | 项目进度情况 |
issuesRisks | string | — | 问题与风险 |
customerVisits | string | — | 客户拜访记录 |
businessOpportunity | string | — | 商机跟进情况 |
kpiCompletion | string | — | KPI完成情况 |
technicalProblems | string | — | 技术难题 |
personnelDynamics | string | — | 人员动态 |
nextDayPlan | string | — | 次日工作计划 |
attachmentFileIds | string[] | — | 附件文件ID列表 |
attachments5 | AttachmentVO[] | — | 附件列表(来自文件服务) |
submitTime | string(date-time) | — | 提交时间 |
approvalTime | string(date-time) | — | 审批时间 |
createTime | string(date-time) | — | 创建时间 |
workItems5 | WorkItemVO[] | — | 工作项列表 |
comments7 | CommentVO[] | — | 评论列表 |
approvalFlow6 | ApprovalFlowItemVO[] | — | 审批流程(来自工作流系统) |
blocks4 | BlockVO[] | — | 规则区块配置 |
错误处理
响应统一信封 { code, message, data },code == 200 为成功。以下是本接口可能返回的开放平台层错误:
| 错误码 | 说明 | 可重试 |
|---|---|---|
| 92101 | 访问凭证无效 | 否 |
| 92201 | 接口未登记或已停用 | 否 |
| 92202 | 超出凭证授权范围——本接口需 office:read | 否 |
| 92204 | 绑定员工无此接口的功能权限 | 否 |
| 92203 | 上游服务调用失败 | 是 |
| 92301 | 请求过于频繁 | 是 |
除此之外,comap-office 自身的业务校验失败会原样透传其业务码与提示
(如字段校验、状态不允许、数据不存在),这类码不在开放平台的号段内,
以响应里的 message 为准。完整的平台层错误码见错误码说明。
← 返回work-report