保存用户收货地址接口

    创建或更新用户的收货地址信息。

    注意事项

    • 该接口采用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 是 收件人姓氏
    email 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 收件人姓氏
    email 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