文档中心 > API类目 > 钉钉API

dingtalk.oapi.processinstance.execute (执行审批操作)

指定模板、实例、节点id和审批人，对某个审批节点进行审批。模板是企业在审批后台编辑好的，审批实例通过开放平台回调获取到，并可通过开放接口读取到审批节点id和审批人

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
actioner_userid	String	必须	manager432		操作人id，通过dingtalk.smartwork.bpms.processinstance.get这个接口可以获取
process_instance_id	String	必须	c8ed4c6b-2c16-40e5-b828-41f1e730bd6f		审批实例id
task_id	Number	必须	12345		任务节点id，dingtalk.smartwork.bpms.processinstance.get接口可获取
result	String	必须	agree		审批操作，同意-agree，拒绝-refuse
remark	String	可选	同意	默认值：null 最大长度：2000	操作评论，可为空

响应参数

名称	类型	示例值	描述
result	Boolean	true	操作结果，true为通过，false为失败
errcode	Number	dingOpenErrcode	dingOpenErrcode
errmsg	String	errorMsg	errorMsg

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/processinstance/execute");
OapiProcessinstanceExecuteRequest req = new OapiProcessinstanceExecuteRequest();
req.setActionerUserid("manager432");
req.setProcessInstanceId("c8ed4c6b-2c16-40e5-b828-41f1e730bd6f");
req.setTaskId(12345L);
req.setResult("agree");
req.setRemark("同意");
OapiProcessinstanceExecuteResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/processinstance/execute");
OapiProcessinstanceExecuteRequest req = new OapiProcessinstanceExecuteRequest();
req.ActionerUserid = "manager432";
req.ProcessInstanceId = "c8ed4c6b-2c16-40e5-b828-41f1e730bd6f";
req.TaskId = 12345L;
req.Result = "agree";
req.Remark = "同意";
OapiProcessinstanceExecuteResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiProcessinstanceExecuteRequest;
$req->setActionerUserid("manager432");
$req->setProcessInstanceId("c8ed4c6b-2c16-40e5-b828-41f1e730bd6f");
$req->setTaskId("12345");
$req->setResult("agree");
$req->setRemark("同意");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/processinstance/execute");

curl -X POST "https://oapi.dingtalk.com/topapi/processinstance/execute" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=67f551bc-dd0f-4189-a2fb-d63915de7eda' \
-d 'actioner_userid=manager432' \
-d 'process_instance_id=c8ed4c6b-2c16-40e5-b828-41f1e730bd6f' \
-d 'remark=%E5%90%8C%E6%84%8F' \
-d 'result=agree' \
-d 'task_id=12345'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiProcessinstanceExecuteRequest("https://oapi.dingtalk.com/topapi/processinstance/execute")

req.actioner_userid="manager432"
req.process_instance_id="c8ed4c6b-2c16-40e5-b828-41f1e730bd6f"
req.task_id=12345
req.result="agree"
req.remark="同意"
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.processinstance.execute");
add_param(pRequest,"actioner_userid","manager432");
add_param(pRequest,"process_instance_id","c8ed4c6b-2c16-40e5-b828-41f1e730bd6f");
add_param(pRequest,"task_id","12345");
add_param(pRequest,"result","agree");
add_param(pRequest,"remark","同意");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.processinstance.execute', {
	'actioner_userid':'manager432',
	'process_instance_id':'c8ed4c6b-2c16-40e5-b828-41f1e730bd6f',
	'task_id':'12345',
	'result':'agree',
	'remark':'同意'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":true,
    "errcode":dingOpenErrcode,
    "errmsg":"errorMsg"
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部