查询某个应用授权appauthtoken的授权信息接口 -凯发app官方网站

支持第三方代理调用

更新时间：2024-08-01 18:56:10

订阅更新

我的文档

设置

通用场景

当商户把服务窗、店铺等接口的权限授权给isv之后，支付宝会给isv颁发一个app_auth_token。如若授权成功之后，isv想知道用户的授权信息，如授权者、授权接口列表等信息，可以调用本接口查询某个app_auth_token对应的授权信息

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.auth.token.app.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

app_auth_token必选string(128)

【描述】应用授权令牌

【示例值】201509bbeff9351ad1874306903e96b91d248a36

参数	类型	是否必选	最大长度	描述	示例值
app_auth_token	string	必选	128	应用授权令牌	201509bbeff9351ad1874306903e96b91d248a36

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.auth.token.app.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'app_auth_token=${app_auth_token}' \
 -f 'biz_content={
	"app_auth_token":"201509bbeff9351ad1874306903e96b91d248a36"
}'

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

user_id必选string(16)

【描述】授权商户的user_id

【示例值】2088102150527498

auth_app_id必选string(16)

【描述】授权商户的appid

【示例值】2013121100055554

expires_in必选number(16)

【描述】应用授权令牌失效时间，单位到秒

【示例值】31536000

auth_start必选date(32)

【描述】授权生效时间

【示例值】2015-11-03 01:59:57

auth_end必选date(32)

【描述】授权失效时间

【示例值】2016-11-03 01:59:57

status必选string(7)

【描述】valid：有效状态；invalid：无效状态

【枚举值】

有效状态: valid

无效状态: invalid

【示例值】valid

auth_methods可选string[](4000)

【描述】当前app_auth_token的授权接口列表

【示例值】["alipay.open.auth.token.app.query","alipay.system.oauth.token","alipay.open.auth.token.app"]

is_by_app_auth｜是否全权委托授权可选boolean(10)

【描述】当商家选择全权委托授权时值为true，未选择时为false。

【示例值】true

参数	类型	是否必选	最大长度	描述	示例值
user_id	string	必选	16	授权商户的user_id	2088102150527498
auth_app_id	string	必选	16	授权商户的appid	2013121100055554
expires_in	number	必选	16	应用授权令牌失效时间，单位到秒	31536000
auth_methods	string[]	可选	4000	当前app_auth_token的授权接口列表	["alipay.open.auth.token.app.query","alipay.system.oauth.token","alipay.open.auth.token.app"]
auth_start	date	必选	32	授权生效时间	2015-11-03 01:59:57
auth_end	date	必选	32	授权失效时间	2016-11-03 01:59:57
status	string	必选	7	valid：有效状态；invalid：无效状态枚举值有效状态: valid 无效状态: invalid	valid
is_by_app_auth	boolean	可选	10	当商家选择全权委托授权时值为true，未选择时为false。	true

响应示例

正常示例

异常示例

{
    "alipay_open_auth_token_app_query_response": {
        "code": "10000",
        "msg": "success",
        "user_id": "2088102150527498",
        "auth_app_id": "2013121100055554",
        "expires_in": 31536000,
        "auth_methods": [
            "alipay.open.auth.token.app.query",
            "alipay.system.oauth.token",
            "alipay.open.auth.token.app"
        ],
        "auth_start": "2015-11-03 01:59:57",
        "auth_end": "2016-11-03 01:59:57",
        "status": "valid",
        "is_by_app_auth": true
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}