文档中心 > API类目 > 闲鱼

qimen.alibaba.idle.recycle.shiptime.check (服务商选择时间校验)

根据下单时候用户选择的类型，渲染出时间选择器，时间选择器内容由服务商返回

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
area	String	可选	余杭区	地区
areaId	String	可选	330110	地区ID
province	String	可选	浙江	省份
town	String	可选	五常	街道
city	String	可选	杭州	城市
sceneType	String	可选	3C	场景：3C_TENDER:上门帮卖 3C：回收
fullAddress	String	可选	杭州市余杭区五常街道文一西路969号	详细地址
shipType	String	可选	1	1：顺丰邮寄 2：服务商上门 3：到店回收 4：菜鸟取件 5：自行邮寄 6：取送一体
cityId	String	可选	330100	城市
townId	String	可选	330100100	街道
provinceId	String	可选	330000	省分
quoteId	String	可选	1234	估价ID
quoteVersion	String	可选	1	估价版本
storeId	String	可选	127001	门店id

响应参数

名称	类型	示例值	描述
success	Boolean	true	是否成功
errCode	String	SYSTEM_ERROR	错误码
errMsg	String	系统错误请稍后再试	错误信息
shipTimeList	ShipTimeQueryResult []		日期列表
children ShipTimeDTO [] 日期下的时间段列表 └ timeBusy Boolean false 是否麻烦 true：不可以预约 false：可以预约 └ startTime String 2023-10-12 13:00:00 开始时间 └ endTIme String 2023-10-12 15:00:00 结束时间 └ timeType String REAL_TIME 为空则展示原普通时间段；REAL_TIME-实时；EVENING-晚间 └ shipDate String 2023-10-12 日期

请求示例

{"area":"余杭区","town":"五常","city":"杭州","cityId":"330100","townId":"330100100","storeId":"127001","provinceId":"330000","quoteId":"1234","quoteVersion":"1","areaId":"330110","province":"浙江","sceneType":"3C","fullAddress":"杭州市余杭区五常街道文一西路969号","shipType":"1"}

响应示例

{
    "success":true,
    "errCode":"SYSTEM_ERROR",
    "errMsg":"系统错误请稍后再试",
    "shipTimeList":[
        {
                "children":[
                    {
                            "timeBusy":false,
                            "startTime":"2023-10-12 13:00:00",
                            "endTIme":"2023-10-12 15:00:00",
                            "timeType":"REAL_TIME"
                    }
                ],
                "shipDate":"2023-10-12"
        }
    ]
}

验签示例

{"success":"false","errCode":"sign-check-failure","errMsg":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部