创建或更新用户的收货地址信息。
注意事项
- 该接口采用POST方法,需要以application/json格式提交数据
- 需要用户登录后才能访问
- 如果提供了ID参数,则更新现有地址;否则创建新地址
- 所有标记为必填的字段都需要提供值
请求地址
{域名地址}/api/order/address
说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/order/address
请求语法
POST {域名地址}/api/order/address
Content-Type: application/json
请求头
此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求参数
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 否 | 地址ID,存在时为更新操作 |
| name | string | 是 | 收件人姓名 |
| last_name | string | 是 | 收件人姓氏 |
| string | 是 | 邮箱地址 | |
| company | string | 否 | 公司名称 |
| phone | string | 是 | 联系电话 |
| province | string | 是 | 省份 |
| city | string | 是 | 城市 |
| country | string | 是 | 区县 |
| address_info | string | 是 | 详细地址 |
| postcode | string | 是 | 邮政编码 |
响应头
此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)。
返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 |
| msg | string | 错误原因说明 |
| data | object | 保存的地址数据 |
data 结果参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | int | 地址ID |
| name | string | 收件人姓名 |
| last_name | string | 收件人姓氏 |
| string | 邮箱地址 | |
| company | string | 公司名称 |
| phone | string | 联系电话 |
| province | string | 省份 |
| city | string | 城市 |
| country | string | 区县 |
| address_info | string | 详细地址 |
| postcode | string | 邮政编码 |
| created_time | int | 创建时间戳 |
| updated_time | int | 更新时间戳 |
| user_id | int | 用户ID |
| status | int | 状态(1:启用,0:禁用) |
使用示例
请求示例(创建新地址)
POST /api/order/address HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json
{
"name": "王先生",
"last_name": "王",
"email": "wang@example.com",
"company": "示例公司",
"phone": "13888888888",
"province": "河南省",
"city": "郑州市",
"country": "中原区",
"address_info": "中原西路233号",
"postcode": "450000"
}
请求示例(更新现有地址)
POST /api/order/address HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json
{
"id": 1,
"name": "王先生",
"last_name": "王",
"email": "wang@example.com",
"company": "示例公司",
"phone": "13888888888",
"province": "河南省",
"city": "郑州市",
"country": "中原区",
"address_info": "中原西路233号",
"postcode": "450000"
}
响应示例
{
"code": 0,
"msg": "保存成功",
"data": {
"id": 1,
"created_time": 1669212548,
"updated_time": 1669212548,
"user_id": 1000,
"name": "王先生",
"last_name": "王",
"email": "wang@example.com",
"company": "示例公司",
"phone": "13888888888",
"province": "河南省",
"city": "郑州市",
"country": "中原区",
"address_info": "中原西路233号",
"postcode": "450000",
"status": 1
}
}
错误代码
| 错误码 | 说明 |
|---|---|
| 0 | OK |
| -1 | 错误,错误原因在 msg 中指出 |
| 1001 | 未登录 |
| 1002 | 未授权 |
| 200 | API 请求 OK |