换取应用授权令牌

换取应用授权令牌。在应用授权的场景下，商户把名下应用授权给ISV后，支付宝会给ISV颁发应用授权码app_auth_code，ISV可通过获取到的app_auth_code换取app_auth_token。app_auth_code作为换取app_auth_token的票据，每次用户授权带上的app_auth_code将不一样，app_auth_code只能使用一次，一天（从当前时间算起的24小时）未被使用自动过期。
刷新应用授权令牌，ISV可通过获取到的refresh_token刷新app_auth_token，刷新后老的refresh_token会在一段时间后失效（失效时间为接口返回的re_expires_in）。

{ "app_auth_token": "201509BBeff9351ad1874306903e96b91d248A36", "app_refresh_token": "201509BBdcba1e3347de4e75ba3fed2c9abebE36", "auth_app_id": "2013121100055554", "expires_in": "123456", "re_expires_in": "123456", "tokens": [ { "app_auth_token": "201509BBeff9351ad1874306903e96b91d248A36", "app_refresh_token": "201509BBdcba1e3347de4e75ba3fed2c9abebE36", "auth_app_id": "2013121100055554", "expires_in": "123456", "re_expires_in": "123456", "user_id": "2088102150527498" } ], "user_id": "2088102150527498" }

请求参数

Body 参数application/json

code

string

可选

应用授权码，传入应用授权后得到的 app_auth_code。说明： grant_type 为 authorization_code 时，本参数必填； grant_type 为 refresh_token 时不填。

示例值:

1cc19911172e4f8aaa509c8fb5d12F56

grant_type

string

可选

授权方式。支持： authorization_code：使用应用授权码换取应用授权令牌app_auth_token。 refresh_token：使用app_refresh_token刷新获取新授权令牌。

示例值:

authorization_code或者refresh_token

refresh_token

string

可选

刷新令牌，上次换取访问令牌时得到。本参数在 grant_type 为 authorization_code 时不填；为 refresh_token 时必填，且该值来源于此接口的返回值 app_refresh_token（即至少需要通过 grant_type=authorization_code 调用此接口一次才能获取）。

示例值:

201509BBdcba1e3347de4e75ba3fed2c9abebE36

示例

返回响应

🟢200common response

application/json

Body

app_auth_token

string

应用授权令牌

可选

示例值:

201509BBeff9351ad1874306903e96b91d248A36

app_refresh_token

string

刷新令牌

可选

示例值:

201509BBdcba1e3347de4e75ba3fed2c9abebE36

auth_app_id

string

可选

授权商户的appid

示例值:

2013121100055554

expires_in

string

可选

该字段已作废，应用令牌长期有效，接入方不需要消费该字段

示例值:

123456

re_expires_in

string

可选

刷新令牌的有效时间（从接口调用时间作为起始时间），单位到秒

示例值:

123456

tokens

array[object (AppTokenExchangeSubElement) {6}]

可选

批量授权换码访问令牌列表

app_auth_token

string

应用授权令牌

可选

示例值:

201509BBeff9351ad1874306903e96b91d248A36

app_refresh_token

string

刷新令牌

可选

示例值:

201509BBdcba1e3347de4e75ba3fed2c9abebE36

auth_app_id

string

授权商户appid

可选

示例值:

2013121100055554

expires_in

string

过期时间

可选

示例值:

123456

re_expires_in

string

刷新令牌过期时间

可选

示例值:

123456

user_id

string

可选

授权商户的user_id

示例值:

2088102150527498

user_id

string

可选

授权商户的user_id

示例值:

2088102150527498

🔴500请求失败