ECJiaWiki:Api:address/add

来自ECJiaWiki
跳到导航 跳到搜索

应用场景

 添加用户收货地址信息

接口名称

 address/add

Header请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
设备唯一ID device-udid String a46d663d675d4858ea7d0a21c2de06e9 设备的唯一编号 1.3.0
设备客户端类型 device-client String android,iphone,h5,weapp 设备类型的描述 1.3.0
产品编号 device-code String 6015 产品编号 1.3.0
API版本 api-version String 1.6 API接口版本号 1.3.0

举例如下

{
    "device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
    "device-client" : "weapp",
    "device-code " : "6015",
    "api-version" : "1.6",
}

Body请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
token请求凭证 token String 79218f8e710fc755a222de45f43c3fd969b87972 调用接口凭证 1.3.0
会员收货地址信息 address address字典 会员收货地址信息 1.3.0
└ 收货人姓名 consignee String 收货人姓名 1.3.0
└ 收货人地址城市id city Int 收货人地址城市id 1.3.0
└ 收货人邮箱地址 email String 收货人邮箱地址 1.3.0
└ 收货人联系电话(手机) mobile String 收货人联系电话(手机) 1.3.0
└ 收货人联系电话(固话) tel String 收货人联系电话(固话) 1.3.0
└ 收货人详细地址 address String 收货人详细地址 1.3.0
└ 收货人详细地址2 address_info String 收货人详细地址(如门牌号,楼层等信息) 1.3.0
└ 收货地址坐标信息 location location字典 收货地址坐标信息 1.3.0
   └ 经度 longitude String 经度 1.3.0
   └ 纬度 latitude String 纬度 1.3.0
└ 是否设为默认地址 set_default String true(true或false字符串形式) 是否设为默认地址 1.3.0
└ 收货人邮编地址 zipcode String 收货人邮编地址 1.3.0
└ 最佳送货时间 best_time String 最佳送货时间 1.3.0
└ 附近标志性建筑 sign_building String 附近标志性建筑 1.3.0

举例如下

"token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",		
"address" : {
      "consignee"  : "小王",
      "city"       : "CN3101",
      "street"     : "CN31010107"
      "email"      : "471010089@qq.com",
      "mobile"     : "13930111111",
      "tel"        : "88009933",
      "address"    : "中山北路3553号",
      "address_info" : "3楼301室",
      "location" : {
            "longitude" : "121.4158625918",
            "latitude"  : "31.235252261217",
      },
      "set_default" : "false",
      "zipcode"    : "222100",
      "best_time"  : "",
      "sign_building" : "五角大楼",  
}

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
成功状态 status status字典 返回接口请求成功状态 1.3.0
└ 是否成功 succeed Int 是否成功(1、代表成功,2、代表错误) 1.3.0
返回信息 data data字典 返回信息 1.3.0
└ 收货地址id address_id Int 收货地址id 1.3.0

成功举例如下

{
      "data" : {
            "address_id" : 1,
      },           
      "status" : {           
            "succeed" : 1,
      }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : 100,
            "error_desc" : "Invalid session",
      }
}


注:错误编码