# 获取微应用后台免登的accessToken新版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调用本接口获取微应用后台免登的accessToken。获取的accessToken只在应用管理后台免登场景中使用。

## **请求**

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

### **请求体**

|    名称     |   类型   | 是否必填 |    示例值     |                描述                |
|-----------|--------|------|------------|----------------------------------|
|  corpid   | String |  是   |  corpxxxx  |            企业的corpId。            |
| ssoSecret | String |  是   | shYgsk7xxx | sso密钥，可以在开发者后台**基本信息**—**开发信息**（**旧版**）页面查看。 |

### **请求示例**

curl

1

2

3

4

5

6

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

\--H 'Content-Type: application/json' \\

\--d '{

    "corpid": "corpxxxx",

    "ssoSecret": "shYgsk7xxx"

}'

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

## **响应**

### **响应体**

|     名称      |   类型   | 示例值  |          描述          |
|-------------|--------|------|----------------------|
| accessToken | String | 1234 | 微应用后台免登的accessToken。 |
|  expireIn   |  Long  | 3600 |        超时时间。         |

### **响应体示例**

1

2

3

4

5

6

7

HTTP/1.1 200 OK

Content-Type:application/json

{

  "accessToken" : "1234",

  "expireIn" : 3600

}

Enter to Rename, ⇧Enter to Preview

### **错误码**

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

| HttpCode |           错误码           |           错误信息            |            说明             |
|----------|-------------------------|---------------------------|---------------------------|
|   400    | invalidClientIdOrSecret | 无效的clientId或者clientSecret | 无效的clientId或者clientSecret |