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

tmall.msf.reservation (喵师傅服务预约API)

喵师傅预约api

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
reserv_info ReservationDTO 可选 预约内容
  • └ outer_id
  • String
  • 必须
  • 112343
  • 内部订单号
  • └ order_ids
  • String
  • 必须
  • 193974981484107, 193974981484107
  • 天猫订单号列表
  • └ service_type
  • String
  • 必须
  • 2
  • 服务类型,0 家装的送货上门并安装 1 单向安装 2 建材的送货上门 3 建材的安装
  • └ resv_time
  • Number
  • 可选
  • 0
  • 预约时间,0:上午,1:下午,2:晚上
  • └ resv_date
  • String
  • 可选
  • 2016-12-31
  • 预约日期,2015-12-15
  • └ worker_mobile
  • String
  • 必须
  • 13833033303
  • 预约工人手机号码
  • └ worker_name
  • String
  • 可选
  • 杨师傅
  • 工人名称
  • └ fail_code
  • Number
  • 可选
  • 1
  • 1:电话占线/无人接听/电话关机 2:未收到货 3:用户暂不需要安装 4:取消安装 5:电话号码错误
  • └ next_resv_time
  • String
  • 可选
  • 2016-12-31 12:00:00
  • 下次预约时间
  • └ success
  • Number
  • 可选
  • 1
  • 1成功 0失败
  • └ worker_id_num
  • String
  • 可选
  • 430442222XXXX
  • 身份证信息
  • └ stop_order_type_check_reason
  • Number
  • 可选
  • 4
  • 跳过订单类型检查的原因ID, 具体原因对应ID值咨询运营,一般不填写
  • └ resv_accurate_time
  • String
  • 可选
  • 10:00-12:00
  • 预约时间段,会取代resv_time的上午/下午/晚上

响应参数

名称 类型 示例值 描述
result String {"errorCode"=0,"gmtCurrentTime"=1450683480135,"object":"reserve success","success"=true} 预约成功,json

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallMsfReservationRequest req = new TmallMsfReservationRequest();
TmallMsfReservationRequest.ReservationDTO obj1 = new TmallMsfReservationRequest.ReservationDTO();
obj1.setOuterId("112343");
obj1.setOrderIds("193974981484107, 193974981484107");
obj1.setServiceType("2");
obj1.setResvTime(0L);
obj1.setResvDate("2016-12-31");
obj1.setWorkerMobile("13833033303");
obj1.setWorkerName("杨师傅");
obj1.setFailCode(1L);
obj1.setNextResvTime("2016-12-31 12:00:00");
obj1.setSuccess(1L);
obj1.setWorkerIdNum("430442222XXXX");
obj1.setStopOrderTypeCheckReason(4L);
obj1.setResvAccurateTime("10:00-12:00");
req.setReservInfo(obj1);
TmallMsfReservationResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_msf_reservation_response>
    <result>{&quot;errorCode&quot;=0,&quot;gmtCurrentTime&quot;=1450683480135,&quot;object&quot;:&quot;reserve success&quot;,&quot;success&quot;=true}</result>
</tmall_msf_reservation_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

返回
顶部