tboss_oa_module/docs/dingtalk/server/JSAPI鉴权-获取jsapiTicket.md

获取jsapiTicket新版SDK

更新于 2026-04-29当开发H5微应用时，需要先通过本接口获取jsapi_ticket，然后再生成鉴权签名，最后调用dd.config完成鉴权。

接口调用说明

企业内部应用是以应用维度获取jsapi_ticket的，所以在使用的时候需要将jsapi_ticket以appKey为维度进行缓存下来（设置缓存过期时间2小时），并不需要每次都通过接口拉取。

请求

基本信息	基本信息
HTTP URL	https://api.dingtalk.com/v1.0/oauth2/jsapiTickets
HTTP Method	POST
支持的应用类型	企业内部应用第三方企业应用
权限要求	调用企业API时需要具备的基本权限

请求头

名称	类型	是否必填	示例值	描述
x-acs-dingtalk-access-token	String	是	BExxx	调用该接口的访问凭证，通过以下获取：

• 企业内部应用，调用获取企业内部应用的accessToken接口获取。

• 第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。 |

请求示例

HTTP

1

2

curl -X POST 'https://api.dingtalk.com/v1.0/oauth2/jsapiTickets' \

  -H 'x-acs-dingtalk-access-token: BExxx'

Enter to Rename, ⇧Enter to Preview

Java

1

// This file is auto-generated, don't edit it. Thanks.

Enter to Rename, ⇧Enter to Preview

Python

1

# -*- coding: utf-8 -*-

Enter to Rename, ⇧Enter to Preview

PHP

1

<?php

Enter to Rename, ⇧Enter to Preview

Go

1

// This file is auto-generated, don't edit it. Thanks.

Enter to Rename, ⇧Enter to Preview

Node.js

1

// This file is auto-generated, don't edit it

Enter to Rename, ⇧Enter to Preview

C#

1

// This file is auto-generated, don't edit it. Thanks.

Enter to Rename, ⇧Enter to Preview

响应

响应体

名称	类型	示例值	描述
jsapiTicket	String	asjdgxxx	返回的jsapi_ticket。
expireIn	Long	7200	jsapiTicket过期时间，单位秒。

响应体示例

1

2

3

4

5

6

7

HTTP/1.1 200 OK

Content-Type:application/json

{

  "jsapiTicket" : "asjdgxxx",

  "expireIn" : 7200

}

Enter to Rename, ⇧Enter to Preview

错误码

若调用该接口报错，可根据错误信息在全局错误码文档中查找解决方案。

HttpCode	错误码	错误信息	说明
400	invalidClientIdOrSecret	无效的clientId或者clientSecret	无效的clientId或者clientSecret
500	systemBusy	系统繁忙	系统繁忙