文档中心 > API类目 > 天猫服务平台

tmall.msf.new.reservation (喵师傅预约api)

喵师傅预约api

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
result String {costTime=null, success=true, errorMessage=null, errorCode=0, gmtCurrentTime=1705494224928, class=com.tmall.msf.common.dto.Result, object={identifyTaskId=252576004, class=com.tmall.msf.common.dto.ReservationVO, object=2024-01-19 }} 预约成功,json

请求示例

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

响应示例

  • XML示例
  • JSON示例
<tmall_msf_new_reservation_response>
    <result>{costTime=null, success=true, errorMessage=null, errorCode=0, gmtCurrentTime=1705494224928, class=com.tmall.msf.common.dto.Result, object={identifyTaskId=252576004, class=com.tmall.msf.common.dto.ReservationVO, object=2024-01-19 }}</result>
</tmall_msf_new_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

返回
顶部