文档中心 > API类目 > 天猫服务商品API

tmall.servicecenter.worker.update (修改工人信息)

修改工人信息。该接口为多个业务公用,部分字段可忽略。对于电器预约安装业务,同一个服务商,通过工人姓名+手机号+biz_type 保证唯一性。工人已存在才可以修改。 错误码如下 100000, 系统错误 100001, 工人信息校验失败 100002, 用户校验失败 100003, 操作失败 10004,工人信息为空 10005,服务商id为空或者服务商名称为空 10006, 工人不存在 10007, 工人已存在 10008, 缺少工人姓名 10009, 缺少工人电话 10010, 网点不存在 11000, category_id 无效 11001, biz_type 无效 20001,已查询到最后一页

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
worker WorkerDto 可选 工人信息
  • address
  • AddressDto
  • 可选
  • 工人居住地址
  • └ address_detail
  • String
  • 可选
  • 22
  • 详细地址,街到门牌,
  • └ address_names
  • String []
  • 可选
  • 222
  • 省/市/区/街道
  • └ biz_type
  • String
  • 可选
  • appliance_install
  • 业务类型,电器预约安装业务填appliance_install
  • └ cover_category_ids
  • String
  • 可选
  • 123|456
  • 工人支持的商品类目id,竖线分隔
  • └ handheld_card_pic
  • String
  • 可选
  • -
  • -
  • └ id_card_pic
  • String
  • 可选
  • -
  • -
  • └ id_card_pic_back
  • String
  • 可选
  • -
  • -
  • └ identity_id
  • String
  • 可选
  • -
  • -
  • └ name
  • String
  • 可选
  • 张三
  • 工人姓名
  • └ phone
  • Number
  • 可选
  • 1234567890
  • 工人手机号
  • └ photo
  • String
  • 可选
  • -
  • -
  • └ provider_id
  • Number
  • 可选
  • 1
  • -
  • └ provider_name
  • String
  • 可选
  • -
  • -
  • └ register_time
  • Date
  • 可选
  • 2016-06-28 10:30:00
  • -
  • service_areas
  • DivisionDto []
  • 可选
  • -
  • └ division_names
  • String []
  • 可选
  • -
  • -
  • └ service_store_code
  • String
  • 可选
  • 网点编码
  • 网点编码
  • └ service_types
  • String []
  • 可选
  • -
  • -
  • └ work_type
  • String
  • 可选
  • -
  • -
  • └ service_codes
  • String
  • 可选
  • xxxx|xxxx
  • serviceCodes 列表,竖线分隔

响应参数

名称 类型 示例值 描述
result ResultBase result
  • └ error_code
  • Number
  • 123
  • errorCode
  • └ error_msg
  • String
  • demo
  • errorMsg
  • └ gmt_create
  • Date
  • 2016-06-28 10:30:00
  • gmtCreate
  • └ gmt_modified
  • Date
  • 2016-06-28 10:30:00
  • gmtModified
  • └ success
  • Boolean
  • false
  • success
  • └ value
  • Boolean
  • 123
  • value

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterWorkerUpdateRequest req = new TmallServicecenterWorkerUpdateRequest();
TmallServicecenterWorkerUpdateRequest.WorkerDto obj1 = new TmallServicecenterWorkerUpdateRequest.WorkerDto();
TmallServicecenterWorkerUpdateRequest.AddressDto obj2 = new TmallServicecenterWorkerUpdateRequest.AddressDto();
obj2.setAddressDetail("22");
obj2.setAddressNames("222");
obj1.setAddress(obj2);
obj1.setBizType("appliance_install");
obj1.setCoverCategoryIds("123|456");
obj1.setHandheldCardPic("-");
obj1.setIdCardPic("-");
obj1.setIdCardPicBack("-");
obj1.setIdentityId("-");
obj1.setName("张三");
obj1.setPhone(1234567890L);
obj1.setPhoto("-");
obj1.setProviderId(1L);
obj1.setProviderName("-");
obj1.setRegisterTime(StringUtils.parseDateTime("2016-06-28 10:30:00"));
List<TmallServicecenterWorkerUpdateRequest.DivisionDto> list4 = new ArrayList<TmallServicecenterWorkerUpdateRequest.DivisionDto>();
TmallServicecenterWorkerUpdateRequest.DivisionDto obj5 = new TmallServicecenterWorkerUpdateRequest.DivisionDto();
list4.add(obj5);
obj5.setDivisionNames("-");
obj1.setServiceAreas(list4);
obj1.setServiceStoreCode("网点编码");
obj1.setServiceTypes("-");
obj1.setWorkType("-");
obj1.setServiceCodes("xxxx|xxxx");
req.setWorker(obj1);
TmallServicecenterWorkerUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_servicecenter_worker_update_response>
    <result>
        <error_code>123</error_code>
        <error_msg>demo</error_msg>
        <gmt_create>2016-06-28 10:30:00</gmt_create>
        <gmt_modified>2016-06-28 10:30:00</gmt_modified>
        <success>false</success>
        <value>123</value>
    </result>
</tmall_servicecenter_worker_update_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

返回
顶部