获取审批实例详情
POST
/topapi/processinstance/get最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口根据审批实例ID,获取审批实例详情。详情包括审批表单信息、操作记录列表、操作人、抄送人、审批任务列表。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
process_instance_id
string
必需
审批实例ID,可通过获取审批实例ID列表接口获取。
示例
{
"process_instance_id": "1a2b-3e4dxxxx"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
request_id
string
请求ID。
errcode
number
返回码。
errmsg
string
返回码描述。
process_instance
object
审批实例详情。
title
string
审批实例标题。
create_time
string
开始时间。
finish_time
string
结束时间。
originator_userid
string
可选
发起人的userid。
originator_dept_id
string
可选
发起人的部门。-1表示根部门。
status
string
可选
审批状态:NEW:新创建RUNNING:审批中TERMINATED:被终止COMPLETED:完成CANCELED:取消
approver_userids
array[string]
可选
审批人userid。手动发起的审批单该参数才返回,使用接口发起的审批单该参数不返回。
cc_userids
array[string]
可选
抄送人userid。
result
string
可选
审批结果:agree:同意refuse:拒绝
business_id
string
审批实例业务编号。
operation_records
array [object {6}]
操作记录列表。
tasks
array [object {7}]
任务列表。
originator_dept_name
string
发起部门。
biz_action
string
可选
审批实例业务动作:MODIFY:表示该审批实例是基于原来的实例修改而来REVOKE:表示该审批实例是由原来的实例撤销后重新发起的NONE表示正常发起
attached_process_instance_ids
array[string]
可选
审批附属实例列表,当已经通过的审批实例被修改或撤销,会生成一个新的实例,作为原有审批实例的附属。如果想知道当前已经通过的审批实例的状态,可以依次遍历它的附属列表,查询里面每个实例的biz_action。
form_component_values
array [object {5}]
表单详情列表。
main_process_instance_id
string
主流程实例标识。
示例
{
"request_id": "string",
"errcode": 0,
"errmsg": "string",
"process_instance": {
"title": "string",
"create_time": "string",
"finish_time": "string",
"originator_userid": "string",
"originator_dept_id": "string",
"status": "string",
"approver_userids": [
"string"
],
"cc_userids": [
"string"
],
"result": "string",
"business_id": "string",
"operation_records": [
{
"userid": "string",
"date": "string",
"operation_type": "string",
"operation_result": "string",
"remark": "string",
"attachments": [
{
"file_name": "string",
"file_size": "string",
"file_id": "string",
"file_type": "string"
}
]
}
],
"tasks": [
{
"userid": "string",
"task_status": "string",
"task_result": "string",
"create_time": "string",
"finish_time": "string",
"taskid": "string",
"url": "string"
}
],
"originator_dept_name": "string",
"biz_action": "string",
"attached_process_instance_ids": [
"string"
],
"form_component_values": [
{
"name": "string",
"value": "string",
"ext_value": "string",
"id": "string",
"component_type": "string"
}
],
"main_process_instance_id": "string"
}
}
最后修改时间: 2 年前