开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
开发文档(v3版) 
支付
私域
公域
营销
资金
会员
支付宝身份验证
app 支付宝登录
获取会员信息
接入指南
api 列表
用户信息
用户授权
人脸认证
信用
安全
广告
小程序云
其他
api文档 >  >  >  >  > 支付宝会员授权信息查询接口
收藏
订阅更新
我的文档
设置

接口说明

接口英文名称:alipay.user.info.share
请求url:https://openapi.alipay.com/v3/alipay/user/info/share
请求方式:post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
配合支付宝会员授权接口,查询授权信息。

公共请求参数

参数类型是否必选最大长度描述示例值
authorizationstring必选1024
请求身份信息,参考验签规则。在header参数中传递
content-typestring可选32
报文内容格式,默认需要使用application/json,加密请求使用text/plain,参考请求规则。在header参数中传递
application/json
x-http-method-overridestring可选16
http方法,对于部分不支持put、patch、delete等操作的情况,可以使用post发送请求,并通过该参数传输实际需要使用的http method,参考请求规则。在header参数中传递
put
alipay-request-idstring可选32
调用方的requestid,用于定位一次请求,需要每次请求保持唯一。排查问题时可以提供该字段,参考请求规则。在header参数中传递。
0ba7cddb1665744697169391253118
alipay-encrypt-typestring可选16
加密算法,请求使用加密能力时,需要指定加密算法,参考加解密规则。在header参数中传递
aes
alipay-root-cert-snstring可选128
支付宝根证书序列号。证书模式时,可传入该参数,支付宝服务端会校验序列号,确保调用方的证书未被篡改,参考验签规则。在header参数中传递
687b59193f3f462dd5336e5abf83c5d8_02941eef3187dddf3d3b83462e1dfcf6
alipay-app-auth-tokenstring可选128
应用授权令牌,参考代调用规则。在header参数中传递
201509bbeff9351ad1874306903e96b91d248a36

业务请求参数

query参数
auth_token|用户授权令牌必选string(64)
【描述】支付宝用户授权令牌,该接口需要用户授权后才能调用。参考参考用户授权。在query参数中传递
【示例值】20120823ac6ffaa4d2d84e7384bf983531473993
常见请求示例
curl -x post \
 "https://openapi.alipay.com/v3/alipay/user/info/share" \
 -h "authorization: alipay-sha256withrsa app_id=${appid},timestamp=${now},nonce=${uuid},expired_seconds=600,sign=${sign}" \
 -h "alipay-request-id: ${requestid}" \
 -h "alipay-app-auth-token: ${app_auth_token}" \
 -h "content-type: application/json" \
 -d '{}'
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
alipay-timestampstring可选32
unix时间戳,用于验签及问题排查,参考验签规则。在header参数中传递
1666004496123
alipay-signaturestring可选512
支付宝响应报文签名,参考验签规则。在header中返回
alipay-traceidstring可选64
支付宝traceid ,用于排查问题使用,参考请求规则。在header中返回
0ba7cddb1665744697169391253118
alipay-noncestring可选64
支付宝nonce标记,每次请求会生成不同的nonce,可用于防重放判断,参考请求规则。在header中返回
515cf24c2f78b13564e94c2a495695ab

业务响应参数

avatar必选string(400)
【描述】用户头像地址。 注意:如果没有数据(用户未设置)时不会返回该信息,请做好容错。
【示例值】http://tfsimg.alipay.com/images/partner/t1uixxxbpxxxxxxxx
city必选string(20)
【描述】市名称。
【示例值】安庆
nick_name必选string(50)
【描述】用户昵称。 注意:如果没有数据(用户未设置)时不会返回该信息,请做好容错。
【示例值】支付宝小二
province必选string(20)
【描述】省份名称。
【示例值】安徽省
以下参数 二选一 
user_idstring(16)
【描述】支付宝用户的userid。
新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看openid配置申请
【示例值】2088102104794936
open_id|支付宝用户的openidstring(128)
【描述】支付宝用户的openid。  详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
gender特殊可选string(10)
【描述】性别。枚举值如下: f:女性; m:男性。
【示例值】f
响应示例
{
	"user_id":"2088102104794936",
	"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
	"avatar":"http://tfsimg.alipay.com/images/partner/t1uixxxbpxxxxxxxx",
	"city":"安庆",
	"nick_name":"支付宝小二",
	"province":"安徽省",
	"gender":"f"
}
说明:本示例仅供参考。

公共错误码

前往查看

业务错误码

状态码错误码错误描述凯发app官方网站的解决方案
400system_error系统繁忙
服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图