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

dingtalk.oapi.gettoken (获取企业token)

获取企业token

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	描述
corpid	String	可选	corpid	企业的corpid
corpsecret	String	可选	corpsecret	企业的密钥
appkey	String	可选	appkey	应用的唯一标识key
appsecret	String	可选	appsecret	应用的密钥

响应参数

名称	类型	示例值	描述
access_token	String	xxx	access_token
expires_in	Number	7200	expires_in
errmsg	String	ok	errmsg
errcode	Number	0	errcode

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
OapiGettokenRequest req = new OapiGettokenRequest();
req.setCorpid("corpid");
req.setCorpsecret("corpsecret");
req.setAppkey("appkey");
req.setAppsecret("appsecret");
req.setHttpMethod("GET");
OapiGettokenResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
OapiGettokenRequest req = new OapiGettokenRequest();
req.Corpid = "corpid";
req.Corpsecret = "corpsecret";
req.Appkey = "appkey";
req.Appsecret = "appsecret";
req.SetHttpMethod("GET");
OapiGettokenResponse 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_GET , DingTalkConstant::$FORMAT_JSON);
$req = new OapiGettokenRequest;
$req->setCorpid("corpid");
$req->setCorpsecret("corpsecret");
$req->setAppkey("appkey");
$req->setAppsecret("appsecret");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/gettoken");

curl -X GET "https://oapi.dingtalk.com/gettoken" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=94ded648-2360-41f7-a36b-3dc4dccfd890' \
-d 'appkey=appkey' \
-d 'appsecret=appsecret' \
-d 'corpid=corpid' \
-d 'corpsecret=corpsecret'

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

req=dingtalk.api.OapiGettokenRequest("https://oapi.dingtalk.com/gettoken")

req.corpid="corpid"
req.corpsecret="corpsecret"
req.appkey="appkey"
req.appsecret="appsecret"
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.gettoken");
add_param(pRequest,"corpid","corpid");
add_param(pRequest,"corpsecret","corpsecret");
add_param(pRequest,"appkey","appkey");
add_param(pRequest,"appsecret","appsecret");
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.gettoken', {
	'corpid':'corpid',
	'corpsecret':'corpsecret',
	'appkey':'appkey',
	'appsecret':'appsecret'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "access_token":"xxx",
    "expires_in":7200,
    "errmsg":"ok",
    "errcode":0
}

异常示例

JSON示例

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.gettoken (获取企业token)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ