tboss_oa_module/docs/dingtalk/server/身份验证-获取微应用后台免登的accessToken.md

获取微应用后台免登的accessToken新版SDK

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

错误码

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

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