文档中心 > API类目 > 菜鸟裹裹API

cainiao.endpoint.locker.top.station.addorupdate (增加更新代收点)

新增或者修改代收点相关信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
station_info StationInfo 可选 站点信息
  • └ zip
  • String
  • 可选
  • 100000
  • 邮编
  • └ station_lng
  • String
  • 可选
  • 120.129872
  • 站点经度
  • └ station_addr
  • String
  • 可选
  • 翡翠城二期(竹苑)
  • 站点详细地址
  • └ station_id
  • String
  • 可选
  • 1232321
  • 站点id
  • └ status
  • Number
  • 必须
  • 0
  • 0-上线,1-下线
  • └ station_name
  • String
  • 可选
  • 翡翠城代收点
  • 站点名字
  • └ housing_estate
  • String
  • 可选
  • 翡翠城
  • 小区
  • └ station_no
  • String
  • 可选
  • 1232321
  • 站点编码
  • └ city
  • String
  • 必须
  • 杭州市
  • 城市
  • └ img_url
  • String
  • 可选
  • http://www.taobao.com
  • 站点照片url
  • └ station_lat
  • String
  • 可选
  • 30.127655
  • 站点纬度
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ coord_type
  • String
  • 可选
  • MARS
  • 坐标类型,MARS-火星坐标(高德坐标),BAIDU-百度坐标,GPS-GPS坐标
  • └ town
  • String
  • 可选
  • 五常街道
  • 街道
  • └ district
  • String
  • 必须
  • 余杭区
  • 区县
  • └ extra
  • String
  • 可选
  • {'rest_of_week':'6,7','service_time':'8:00-20:00'}
  • 站点服务能力描述
  • └ station_type
  • Number
  • 必须
  • 100
  • 站点类型:100-代收点
  • └ contact
  • String
  • 必须
  • 18677622666
  • 站点联系方式

响应参数

名称 类型 示例值 描述
result SingleResult result result
  • └ error_desc
  • String
  • 数据库操作失败
  • 错误描述
  • └ error_code
  • String
  • 200
  • 错误编码,见白皮书
  • └ success
  • Boolean
  • true
  • 本次调用是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoEndpointLockerTopStationAddorupdateRequest req = new CainiaoEndpointLockerTopStationAddorupdateRequest();
CainiaoEndpointLockerTopStationAddorupdateRequest.StationInfo obj1 = new CainiaoEndpointLockerTopStationAddorupdateRequest.StationInfo();
obj1.setZip("100000");
obj1.setStationLng("120.129872");
obj1.setStationAddr("翡翠城二期(竹苑)");
obj1.setStationId("1232321");
obj1.setStatus(0L);
obj1.setStationName("翡翠城代收点");
obj1.setHousingEstate("翡翠城");
obj1.setStationNo("1232321");
obj1.setCity("杭州市");
obj1.setImgUrl("http://www.taobao.com");
obj1.setStationLat("30.127655");
obj1.setProvince("浙江省");
obj1.setCoordType("MARS");
obj1.setTown("五常街道");
obj1.setDistrict("余杭区");
obj1.setExtra("{'rest_of_week':'6,7','service_time':'8:00-20:00'}");
obj1.setStationType(100L);
obj1.setContact("18677622666");
req.setStationInfo(obj1);
CainiaoEndpointLockerTopStationAddorupdateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_endpoint_locker_top_station_addorupdate_response>
    <result>
        <error_desc>数据库操作失败</error_desc>
        <error_code>200</error_code>
        <success>true</success>
    </result>
</cainiao_endpoint_locker_top_station_addorupdate_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部