接口说明
接口英文名称:alipay.user.info.share
请求url:https://openapi.alipay.com/v3/alipay/user/info/share
请求方式:post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
通用场景
配合支付宝会员授权接口,查询授权信息。
公共请求参数
业务请求参数
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 '{}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
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官方网站的解决方案 |
---|---|---|---|
400 | system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |