支付宝小程序API 获取会员收货地址
2020-09-16 15:50 更新
my.getAddress
版本要求:基础库 1.20.4 或更高版本,若版本较低,建议做 兼容处理。
注意**:**
- 由于开发者工具版本限制,目前 my.getAddress 接口暂不支持在开发者工具调试和真机调试,仅支持真机预览。开发者请调至 预览 模式,在支付宝客户端扫码查看效果。
- 此 API 暂仅支持企业支付宝账户使用。
商户在寄送外卖、快递或其他场景需要用户填写地址信息时,可通过调用此 API 直接获取地址数据,无需用户手动填写。
调用接口时会弹出授权框,用户点击弹框按钮同意授权后,可以通过接口获取到返回的收货地址数据。若用户未授权,则无法返回正确信息。
示例代码
my.getAddress({
success: (res) => {
my.alert({
title: JSON.stringify(res)
});
}
});
入参
Object 类型,属性如下:
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)。 |
接口返回值
success 返回值
Object 类型,属性如下:
名称 | 类型 | 描述 |
---|---|---|
address | String | 详细地址。 |
country | String | 国家名称。 |
prov | String | 省。 |
city | String | 市。 |
area | String | 区。 |
street | String | 街道。 |
fullname | String | 用户名。 |
mobilePhone | String | 手机号。 |
正常响应
// 正常响应
{
"resultStatus": "9000",
"result": {
"address": "浙江省杭州市西湖区西溪路556号", // 详细地址
"country": "中国", // 国家名称
"prov": "浙江省", // 省
"city": "杭州市", // 市
"area": "西湖区", // 区
"street": "", // 街道
"fullname": "张三", // 名称
"mobilePhone": "182XXXXXXX" // 手机号
}
}
服务端接口异常响应
// 用户取消操作响应
{
"result": '',
"resultStatus": '6001'
}
// 用户拒绝授权响应
{
"error": 4,
"errorMessage": "无权调用该接口"
}
以上内容是否对您有帮助:
更多建议: