![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 16 (modified by zhanzhenchao, 10 years ago) (diff) |
|---|
用户收货信息
获取默认收货地址
线上：/appIntf/useraddress/getDefaultAddress.jsp
说明
获取默认收货地址
提交方式
get
是否需要登录
true
缓存方式
无
缓存时间
无
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id(cookie参数) | 登录sessionId | string | "" | 是 |
返回
result {
status: 1,
msg: "请求成功",
data: {
addrId: 123456, //地址Id
name: "rico", //用户名
province: "13-河北", //省
city: "1303-秦皇岛", //城市
county: "130324-卢龙县", //县，区
phone: "15952352365", //电话
detail: "广州市天河区天河软件园高普路115号太平洋网络", //详细地址
idcardNo: "445185455623562955", //身份证号码
idcardImga: "http://img.pconline.com.cn/images/upload/upc/tx/pcbest_buy/a.jpg", //身份证正面
idcardImgb: "http://img.pconline.com.cn/images/upload/upc/tx/pcbest_buy/b.jpg", //身份证反面
postcode: "510006" //邮政编码
}
}
状态码
| status | msg | 含义 |
|---|---|---|
| 1 | 请求成功 | 请求成功 |
| -1 | 请求失败 | 后台数据操作错误 |
| -2 | 未登录 | 未登录 |
| 43 | 该用户还没有默认地址 | 该用户还没有默认地址 |
获取用户的地址列表
线上：/appIntf/useraddress/listUserAddress.jsp
说明
获取用户的地址列表
提交方式
get
是否需要登录
true
缓存方式
无
缓存时间
无
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id(cookie参数) | 登录sessionId | string | "" | 是 |
返回
result {
status: 1,
msg: '请求成功',
data: [
{
addrId: 123456, //地址Id
name: "rico", //用户名
province: "13-河北", //省
city: "1303-秦皇岛", //城市
county: "130324-卢龙县", //县，区
phone: "15952352365", //电话
detail: "广州市天河区天河软件园高普路115号太平洋网络", //详细地址
idcardNo: "445185455623562955", //身份证号码
idcardImga: "http://img.pconline.com.cn/images/upload/upc/tx/pcbest_buy/a.jpg", //身份证正面
idcardImgb: "http://img.pconline.com.cn/images/upload/upc/tx/pcbest_buy/b.jpg", //身份证反面
postcode: "510006", //邮政编码
isdefault: 0 //是否默认地址 1是，0否
}
]
}
状态码
| status | msg | 含义 |
|---|---|---|
| 1 | 请求成功 | 请求成功 |
| -1 | 请求失败 | 后台数据操作错误 |
| -2 | 未登录 | 未登录 |
| 43 | 该用户还没有默认地址 | 该用户还没有默认地址 |
添加收货地址
线上：/appIntf/useraddress/addUserAddress.jsp
说明
用户添加收货地址
提交方式
post
是否需要登录
true
缓存方式
无
缓存时间
无
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id(cookie参数) | 登录sessionId | string | "" | 是 |
| name | 收货人名字 | string | "" | 是 |
| province | 省份 | string | "" | 是 |
| city | 城市 | string | "" | 是 |
| county | 县区 | string | "" | 是 |
| phone | 手机号码 | string | "" | 是 |
| detail | 详细地址 | string | "" | 是 |
| idcardNo | 身份证号码 | string | "" | 是 |
| idcardImga | 身份证正面链接 | string | "" | 是 |
| idcardImgb | 身份证反面链接 | string | "" | 是 |
| postcode | 邮政编码 | string | "" | 是 |
| isdefault | 默认地址 | int | 0 | 否 |
返回
result {
status: 1,
msg: "请求成功"
}
状态码
| status | msg | 含义 |
|---|---|---|
| 1 | 请求成功 | 请求成功 |
| -1 | 请求失败 | 后台数据操作错误 |
| -2 | 未登录 | 未登录 |
| -3 | 非法请求！ | 非post请求 |
| -4 | 验证出错！ | 签名验证未通过 |
| 30 | 关键参数不能为空 | 必须提价的参数不能为空值 |
| 31 | 收货人姓名不符合要求 | 长度为20，且支持汉字、字母、数字输入，不支持特殊字符 |
| 32 | 省份格式不符合要求 | 格式按照默认规定提交 |
| 33 | 城市格式不符合要求 | 格式按照默认规定提交 |
| 34 | 县区格式不符合要求 | 格式按照默认规定提交 |
| 35 | 详细地址格式不符合要求 | 长度为60，且支持汉字、字母、数字输入，不支持特殊字符 |
| 36 | 邮政编码不符合要求 | 长度为6，且仅支持数字输入 |
| 37 | 手机号码不符合要求 | 长度为11，且仅支持数字输入 |
| 38 | 身份证号码不符合格式 | 长度为15或18，且仅支持数字或字母输入 |
| 39 | 身份证照片不能为空 | 身份证照片链接不能为空 |
| 40 | 最多可创建20个收货地址 | 每个用户收货地址不能超过20个 |
| 41 | 请勿重复提交 | 5秒内不能重复提交 |
修改收货地址
线上：/appIntf/useraddress/updateUserAddress.jsp
说明
修改用户的收货地址
提交方式
post
是否需要登录
true
缓存方式
无
缓存时间
无
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id(cookie参数) | 登录sessionId | string | "" | 是 |
| addrId | 用户地址Id | int | "" | 是 |
| name | 收货人名字 | string | "" | 是 |
| province | 省份 | string | "" | 是 |
| city | 城市 | string | "" | 是 |
| county | 县区 | string | "" | 是 |
| phone | 手机号码 | string | "" | 是 |
| detail | 详细地址 | string | "" | 是 |
| idcardNo | 身份证号码 | string | "" | 是 |
| idcardImga | 身份证正面链接 | string | "" | 是 |
| idcardImgb | 身份证反面链接 | string | "" | 是 |
| postcode | 邮政编码 | string | "" | 是 |
返回
result {
status: 1,
msg: "请求成功"
}
状态码
| status | msg | 含义 |
|---|---|---|
| 1 | 请求成功 | 请求成功 |
| -1 | 请求失败 | 后台数据操作错误 |
| -2 | 未登录 | 未登录 |
| -3 | 非法请求！ | 非post请求 |
| -4 | 验证出错！ | 签名验证未通过 |
| 15 | 收货地址不存在！ | 根据addrId找不到用户收货地址 |
| 30 | 关键参数不能为空 | 必须提价的参数不能为空值 |
| 31 | 收货人姓名不符合要求 | 长度为20，且支持汉字、字母、数字输入，不支持特殊字符 |
| 32 | 省份格式不符合要求 | 格式按照默认规定提交 |
| 33 | 城市格式不符合要求 | 格式按照默认规定提交 |
| 34 | 县区格式不符合要求 | 格式按照默认规定提交 |
| 35 | 详细地址格式不符合要求 | 长度为60，且支持汉字、字母、数字输入，不支持特殊字符 |
| 36 | 邮政编码不符合要求 | 长度为6，且仅支持数字输入 |
| 37 | 手机号码不符合要求 | 长度为11，且仅支持数字输入 |
| 38 | 身份证号码不符合格式 | 长度为15或18，且仅支持数字或字母输入 |
| 39 | 身份证照片不能为空 | 身份证照片链接不能为空 |
| 42 | 不能越权操作 | 发送的addrId不是该用户拥有的地址编号 |
删除地址
线上：/appIntf/useraddress/deleteUserAddress.jsp
说明
删除用户地址
提交方式
post
是否需要登录
true
缓存方式
无
缓存时间
无
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id(cookie参数) | 登录sessionId | string | "" | 是 |
| addrId | 用户地址Id | int | 0 | 是 |
返回
result {
status: 1,
msg: "请求成功"
}
状态码
| status | msg | 含义 |
|---|---|---|
| 1 | 请求成功 | 请求成功 |
| -1 | 请求失败 | 后台数据操作错误 |
| -2 | 未登录 | 未登录 |
| -3 | 非法请求！ | 非post请求 |
| -4 | 验证出错！ | 签名验证未通过 |
| 15 | 收货地址不存在！ | 根据addrId找不到用户收货地址 |
| 42 | 不能越权操作 | 发送的addrId不是该用户拥有的地址编号 |
设置默认地址
线上：/appIntf/useraddress/setDefaultAddress.jsp
说明
设置用户的默认地址
提交方式
post
是否需要登录
true
缓存方式
无
缓存时间
无
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id(cookie参数) | - | string | "" | 是 |
| addrId | 用户地址Id | int | 0 | 是 |
返回
result {
status: 1,
msg: "请求成功"
}
状态码
| status | msg | 含义 |
|---|---|---|
| 1 | 请求成功 | 请求成功 |
| -1 | 请求失败 | 后台数据操作错误 |
| -2 | 未登录 | 未登录 |
| -3 | 非法请求！ | 非post请求 |
| -4 | 验证出错！ | 签名验证未通过 |
| 15 | 收货地址不存在！ | 根据addrId找不到用户收货地址 |
| 42 | 不能越权操作 | 发送的addrId不是该用户拥有的地址编号 |
