换取授权访问令牌

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/system/oauth/token' \ --header 'Content-Type: application/json' \ --data-raw '{ "code": "4b203fe6c11548bcabd8da5bb087a83b", "grant_type": "authorization_code", "refresh_token": "201208134b203fe6c11548bcabd8da5bb087a83b" }'

{ "access_token": "20120823ac6ffaa4d2d84e7384bf983531473993", "alipay_user_id": "已废弃，请勿使用", "auth_token_type": "permanent", "expires_in": "3600", "open_id": "074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5", "re_expires_in": "3600", "refresh_token": "20120823ac6ffdsdf2d84e7384bf983531473993", "union_id": "092aSPrsmhTbexLh9zgoYb2uvZNC4D8izCpGKTem8QiIOQb", "user_id": "2088102150477652", "auth_start": {} }

请求参数

Body 参数application/json

code

string

可选

授权码，用户对应用授权后得到。本参数在 grant_type 为 authorization_code 时必填；为 refresh_token 时不填。

示例值:

4b203fe6c11548bcabd8da5bb087a83b

grant_type

string

授权方式

可选

示例值:

authorization_code

refresh_token

string

可选

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

示例值:

201208134b203fe6c11548bcabd8da5bb087a83b

示例

返回响应

🟢200common response

application/json

Body

access_token

string

可选

访问令牌。通过该令牌调用需要授权类接口

示例值:

20120823ac6ffaa4d2d84e7384bf983531473993

alipay_user_id

string

已废弃，请勿使用

可选

示例值:

已废弃，请勿使用

auth_token_type

string

可选

令牌类型，permanent表示返回的access_token和refresh_token永久有效，非永久令牌不返回该字段

示例值:

permanent

expires_in

string

可选

访问令牌的有效时间，单位是秒。

示例值:

3600

open_id

string

支付宝用户唯一标识

可选

示例值:

074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5

re_expires_in

string

可选

刷新令牌的有效时间，单位是秒。

示例值:

3600

refresh_token

string

可选

刷新令牌。通过该令牌可以刷新access_token

示例值:

20120823ac6ffdsdf2d84e7384bf983531473993

union_id

string

可选

union_id是支付宝用户在开放平台的唯一标识符，在配置应用分组后会返回该值。同一用户的union_id在同一分组内应用保持一致。

示例值:

092aSPrsmhTbexLh9zgoYb2uvZNC4D8izCpGKTem8QiIOQb

user_id

string

可选

支付宝用户的唯一标识。以2088开头的16位数字。

示例值:

2088102150477652

auth_start

string

可选

授权token开始时间，作为有效期计算的起点

示例值:

{}

🔴500请求失败