ECJia到家接口开放中心

应用场景[编辑]

 添加用户收货地址信息

接口名称[编辑]

 address/add

Header请求参数[编辑]

字段名	变量名	必填	类型	示例值	描述	since
设备唯一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
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
成功状态	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",
      }
}

注:错误编码

ECJia到家接口开放中心

地址

目录

应用场景[编辑]

接口名称[编辑]

Header请求参数[编辑]

举例如下[编辑]

Body请求参数[编辑]

举例如下[编辑]

返回参数[编辑]

成功举例如下[编辑]

失败举例如下[编辑]