获取审批实例详情

说明

调用本接口根据审批实例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"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

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"
  }
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限