获取用户token
POST
/v1.0/oauth2/userAccessToken最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取用户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。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
accessToken
string
可选
生成的accessToken。
refreshToken
string
可选
生成的refresh_token。可以使用此刷新token,定期的获取用户的accessToken
expireIn
integer
超时时间,单位秒。
corpId
string
可选
所选企业corpId。
示例
{
"accessToken": "string",
"refreshToken": "string",
"expireIn": 0,
"corpId": "string"
}
最后修改时间: 2 年前