# 获取jsapiTicket新版SDK

![AI 智能摘要](https://gw.alicdn.com/imgextra/i4/O1CN01Zx4PED22rkUkmRe1L_!!6000000007174-2-tps-226-40.png)![>](https://gw.alicdn.com/imgextra/i2/O1CN01UwOv1C27lrTuGFj2D_!!6000000007838-2-tps-17-30.png)

更新于 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

### **错误码**

若调用该接口报错，可根据错误信息在[全局错误码](https://open.dingtalk.com/document/development/server-api-error-codes-1#)文档中查找解决方案。

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