目录
根据汇报记录单号查询企业微信“汇报应用”的汇报详情。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/journal/get_record_detail?access_token=ACCESS_TOKEN
请求示例
{
"journaluuid": "41eJejN57EJNzr8HrZfmKyCN7xwKw1qRxCZUxCVuo9fsWVMSKac6nk4q8rARTDaVNdx"
}
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | 调用接口凭证 |
journaluuid | 是 | string | - 不多于256字节 |
权限说明:
调用的应用需要满足如下的权限:
应用类型 | 权限要求 |
---|---|
自建应用 | 需要配置到「汇报 - 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"info": {
"journal_uuid": "41eJejN57EJNzr8HrZfmKyJZ6E3W9NQbr94x6QEA6MwvK2sVqFQNWy4BaF4Ptyzk26",
"template_name": "今日工作汇报",
"report_time": 1606365591,
"submitter": {
"userid": "LiQiJun"
},
"receivers": [
{
"userid": "LiQiJun"
}
],
"readed_receivers": [
{
"userid": "LiQiJun"
}
],
"apply_data": {
"contents": [
{
"control": "Text",
"id": "Text-1606365477123",
"title": [
{
"text": "工作内容"
}
],
"value": {
"text": "今日暂无工作",
"tips": [],
"members": [],
"departments": [],
"files": [],
"children": [],
"stat_field": [],
"sum_field": [],
"related_approval": [],
"students": [],
"classes": []
}
}
]
},
"comments": [
{
"commentid": 6899287783354824502,
"tocommentid": 0,
"comment_userinfo": {
"userid": "LiYiBo"
},
"content": "加油",
"comment_time": 1606365615
}
]
}
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 错误码描述 |
info | obj | 汇报详情 |
info.journal_uuid | string | 汇报记录id |
info.template_name | string | 汇报表单名称 |
info.template_id | string | 汇报表单id |
info.report_time | int32 | 汇报时间 |
info.submitter | obj | 汇报提交者 |
info.submitter.userid | string | 汇报用户id |
info.receivers | obj[] | 汇报接收对象 |
info.receivers.userid | string | 接收用户id |
info.readed_receivers | obj[] | 已读用户 |
info.readed_receivers.userid | string | 已读用户id |
info.apply_data | obj | 表单数据 |
info.apply_data.contents | obj[] | 表单字段列表 |
info.apply_data.contents.control | string | 控件类型:Text-文本;Textarea-多行文本;Number-数字;Money-金额;Date-日期/日期+时间;Selector-单选/多选;;Contact-成员/部门;Tips-说明文字;File-附件;Table-明细;DateRange-时长;Doc-文档;WedriveFile-微盘附件 |
info.apply_data.contents.id | string | 控件id |
info.apply_data.contents.title | obj | 控件名称 ,若配置了多语言则会包含中英文的控件名称 |
info.apply_data.contents.value | obj | 控件值 ,包含了申请人在各种类型控件中输入的值,不同控件有不同的值,具体说明详见附录 |
info.sys_journal_data | string | “汇报”模板数据,内容为富文本。“汇报”模板是一个特殊模板其表单不在apply_data中返回 |
info.comments | obj[] | 评论 |
info.comments.commentid | uint64 | 评论id |
info.comments.tocommentid | uint64 | 评论回复id |
info.comments.comment_userinfo | obj | 评论用户 |
info.comments.comment_userinfo.userid | string | 评论用户id |
info.comments.content | string | 评论内容 |
info.comments.comment_time | uint32 | 评论时间 |
{
"text": "文本填写的内容"
}
参数 | 说明 |
---|---|
text | 文本内容,即申请人在此控件填写的文本内容 |
{
"new_number": "700"
}
参数 | 说明 |
---|---|
new_number | 数字内容,即申请人在此控件填写的数字内容 |
{
"new_money": "700"
}
参数 | 说明 |
---|---|
new_money | 金额内容,即申请人在此控件填写的金额内容 |
{
"date": {
"type": "day",
"s_timestamp": "1569859200"
}
}
参数 | 说明 |
---|---|
date | 日期/日期+时间内容,即申请人在此控件选择的 日期/日期+时间内容 |
└ type | 时间展示类型:day-日期;hour-日期+时间;month-月份;minute-时分 |
└ s_timestamp | 时间戳,字符串类型。若type为minute,则为从0点的偏移秒数 |
{
"selector": {
"type": "multi",
"options": [
{
"key": "option-15111111111",
"value": [
{
"text": "选项1"
}
]
},
{
"key": "option-15222222222",
"value": [
{
"text": "选项2"
}
]
}
]
}
}
参数 | 说明 |
---|---|
selector | 选择内容,即申请人在此控件选择的选项内容 |
└ type | 选择类型:single-单选;multi-多选 |
└ options | 申请人所选择的选项,多选情况下可能有多个(仅包含申请人所选择的选项,并非所有选项,若需要了解所有选项,需使用“获取审批模板详情”接口) |
└ └ key | 选项key,选项的唯一id,可通过“获取审批模板详情”接口获得(2022-08-25后新创建的企业,不再支持关联审批模板) |
└ └ value | 选项值 |
{
"members": [
{
"userid": "WuJunJie"
},
{
"userid": "WangXiaoMing"
}
]
}
参数 | 说明 |
---|---|
members | 成员内容,即申请人在此控件选择的成员,多选模式下可能有多个 |
└ userid | 成员的userid |
{
"departments": [
{
"openapi_id": "2"
},
{
"openapi_id": "3"
}
]
}
参数 | 说明 |
---|---|
departments | 部门内容,即申请人在此控件选择的部门,多选模式下可能有多个 |
└ openapi_id | 部门id |
此控件不显示在审批详情中,故value为空
{
"files": [
{
"file_id": "WWCISP_v2z8qZENw2qwSiNroVKykbxxMXvmI1lELzG-fo25Y9n1duozezKEu6zSIvOHPCd9_8s934AJncRz5f9G4E_nCQonUHLdiAnCLjfZQQwVaiG7krKzyGB1MpYa9ZVkk0gQ7P8HvO_SOdwzLwpyUZ3Tm2ApyoO_78nTM-iEkf_TILqXuYxKd7ByYL34wMA9Czf6Iy151tHbcYNvbNZZHTnL4UMQdohJ_MPYA2Wz00IebZb3_UuIk5MdJSH_IKlZn9Ms5"
},
{
"file_id": "WWCISP_gZ3BMg5hwI1Adi16NwzJgpi9zp6QQjMdYcuemVWBeHnmMK3QJOYiIIkHvRIh0ysZcAo6gJp069o5tx7qxVzin1Q9LKswff624E1qCCmt088ISBVPScoqEiG4YTI_Kltrqn7b0wvMTudd9lIE3ywgHatPRWKxsHNsSxEY_FuaFWlGHzxcYKNq_LIfVBXZGji-C5bXp23MwpTcCXYfWPfSEpEeXW5c5sQscY_MeW5uc0gITpeFKFXARXmKC62_u7Ln"
}
]
}
参数 | 说明 |
---|---|
files | 文件内容,即申请人在此控件上传的文件内容,可能有多个 |
└ file_id | 文件的media_id,具体使用请参考:文档-获取临时素材 |
{
"children": [
{
"list": [
{
"control": "Text",
"id": "Text-15111111111",
"title": [
{
"text": "明细内文本控件"
}
],
"value": {
"text": "明细文本"
}
}
]
}
]
}
参数 | 说明 |
---|---|
children | 明细内容,一个明细控件可能包含多个子明细 |
└ list | 子明细列表,包含了申请人在子明细的所有子控件中填写的内容,子控件的数据接口同一般控件 |
{
"date_range": {
"type": "halfday",
"new_begin": 1570550400,
"new_end": 1570593600,
"new_duration": 86400
}
}
参数 | 说明 |
---|---|
date_range | 时长组件 |
└ type | 时间展示类型:halfday-日期;hour-日期+时间 |
└ new_begin | 开始时间,unix时间戳 |
└ new_end | 结束时间,unix时间戳 |
└ new_duration | 时长范围, 单位秒 |
{
"location": {
"latitude": "30.547239",
"longitude": "104.063291",
"title": "腾讯科技(成都)有限公司(腾讯成都大厦)",
"address": "四川省成都市武侯区天府三街198号腾讯成都大厦A座",
"time": 1605690460
}
}
参数 | 说明 |
---|---|
latitude | 纬度,精确到6位小数 |
longitude | 经度,精确到6位小数 |
title | 地点标题 |
address | 地点详情地址 |
time | 选择地点的时间(已废弃) |
{
"formula": {
"value": "5.0"
}
}
参数 | 说明 |
---|---|
value | 公式的值 |
{
"students": [
{
"name": "Jackie"
},
{
"name": "Tom"
}
]
}
参数 | 说明 |
---|---|
students | 学生内容,即申请人在此控件选择的 学生,多选模式下可能有多个 |
└ name | 学生名 |
{
"classes": [
{
"name": "1班",
},
{
"name": "2班",
}
]
}
参数 | 说明 |
---|---|
classes | 班级内容,即申请人在此控件选择的班级,多选模式下可能有多个 |
└ name | 班级名 |
{
"docs": [
{
"docid": "xxx_j",
"doc_url": "https://doc.weixin.qq.com/doc/xxx_j"
}
]
}
参数 | 说明 |
---|---|
docs | 文档内容 |
└ docid | 文档的docid |
└ doc_url | 文档的访问链接 注:企业微信4.0.20版本后,不会有新增的文档控件数据。开发者可通过此url进一步查看/导出文档 |
{
"wedrive_files": [
{
"fileid": "xxxx"
}
]
}
参数 | 说明 |
---|---|
wedrive_files | 微盘文件内容 |
└ fileid | 微盘的fileid,可通过下载微盘文件 接口下载文件 |
错误说明:
错误码 | 说明 |
---|---|
301065 | 无汇报应用数据拉取权限 |
301066 | 请求参数错误 |
301067 | 接口内部失败 |