获取用户token

POST

http://127.0.0.1/v1.0/oauth2/userAccessToken

新版服务端API（DingTalk OpenAPI）/获取访问凭证/获取用户个人身份访问凭证

最后修改时间：2022-08-30 09:19:23

责任人：未设置

说明

调用本接口获取用户token。
服务地址：api.dingtalk.com

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	默认开通	API Explorer
第三方企业应用	支持	默认开通	API Explorer
第三方个人应用	支持	默认开通	API Explorer

请求参数

Body 参数application/json

clientId

string

必需

应用id。可使用扫码登录应用或者第三方个人小程序的appId。企业内部应用传应用的AppKey第三方企业应用传应用的SuiteKey第三方个人应用传应用的AppId

clientSecret

string

必需

应用密钥。企业内部应用传应用的AppSecret第三方企业应用传应用的SuiteSecret第三方个人应用传应用的AppSecret

code

string

可选

OAuth 2.0 临时授权码。

refreshToken

string

可选

OAuth2.0刷新令牌，从返回结果里面获取。

grantType

string

必需

如果使用授权码换token，传authorization_code。如果使用刷新token换用户token，传refresh_token。

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/v1.0/oauth2/userAccessToken' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

accessToken

string

可选

生成的accessToken。

refreshToken

string

可选

生成的refresh_token。可以使用此刷新token，定期的获取用户的accessToken

expireIn

integer

超时时间，单位秒。

可选

corpId

string

可选

所选企业corpId。

示例

{
  "accessToken": "string",
  "refreshToken": "string",
  "expireIn": 0,
  "corpId": "string"
}

根据设备ID查询设备

获取企业内部应用的accessToken

获取用户token

说明#

权限#

请求参数

示例代码

返回响应

说明

权限