更新时间:2021-12-20
当开发H5微应用时,需要先通过本接口获取jsapi_ticket,然后再生成鉴权签名,最后调用dd.config完成鉴权。
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 调用企业API基础权限 | API Explorer |
第三方企业应用 | 支持 | 调用企业API基础权限 | API Explorer |
第三方个人应用 | 暂不支持 | 调用企业API基础权限 | 暂不支持 |
请求方法
POST /v1.0/oauth2/jsapiTickets HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
Header参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
jsapiTicket | String | 返回的jsapi_ticket。 |
expireIn | Long | jsapi_ticket超时时间。 |
示例
请求示例
POST /v1.0/oauth2/jsapiTickets HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:BExxx
Content-Type:application/json
返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"jsapiTicket" : "asjdgxxx",
"expireIn" : 3600
}
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidClientIdOrSecret | 无效的clientId或者clientSecret | 无效的clientId或者clientSecret |
500 | systemBusy | 系统繁忙 | 系统繁忙 |