文档中心 > API类目 > 旅行用车API

qimen.alitrip.rentcar.store.range.info.query (同步门店服务范围信息数据)

商品库拉取信息-门店服务范围信息拉取；飞猪每天定时调用此接口按照供应商门店Code分批拉取供应商所有门店服务范围信息；门店范围信息为必传。此门店范围信息将被用作报价查询时飞猪端的预搜索，如果飞猪端根据搜索位置命中不到门店服务范围，将不会再请求供应商报价。

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
traceId	String	必须	215045d716776565095286972e11b4	raceId
searchReq	SearchReq	必须		筛选条件
└ storeCodeList String [] 必须供应商门店Code集合

响应参数

名称	类型	示例值	描述
searchResp	SearchResp		返回信息
storeServiceList StoreService [] 门店服务范围列表 └ storeCode String 1100 供应商门店Code,保证唯一 storeServiceRangeList StoreServiceRange [] 门店服务范围信息 └ rangeCode String 10 服务商范围Code,保证一个门店下唯一 └ rangeName String 朝阳服务圈服务商范围名称 └ isActive Boolean true 是否有效true有效, false无效 └ rangeType Number 1 服务圈类型，1-圆形，2-多边形，3-当前所在城市 └ pickUpType Number 1 取还车方式1 自行到店,2 送车上门,3 接至门店 circleList Circle [] 圆型服务范围，仅在rangeType为1时有效 └ longitude String 116.23232 经度，依照高德经纬度格式，精确到小数点后5位即可 └ latitude String 39.52555 纬度，依照高德经纬度格式，精确到小数点后5位即可 └ radius Number 19999 半径, 单位米 polygonList Polygon [] 自定义封闭图形集合，仅在rangeType为2时有效 point Point [] 点位集合，需要首位相连，连成的图形不可以相交 └ longitude String 116.23232 经度，依照高德经纬度格式，精确到小数点后5位即可 └ latitude String 39.23232 纬度，依照高德经纬度格式，精确到小数点后5位即可 serviceInfoList ServiceInfo [] 服务范围信息（最多3组服务信息） └ startTime String 08:00 服务范围营业开始时间,格式为HH:mm，最大值为23:59分 └ endTime String 22:00 服务范围营业结束时间,格式为HH:mm，最大值为23:59分 └ chargeType Number 0 收费方式 0:免费, 1:收费 └ chargeFee String 30.00 营业时间段总价格精确到2位小数;单位:元。如：200.07，表示：200元7分，仅当chargeType为1时有效 └ advanceBookingTime Number 1 (已废弃)服务范围最短提前预定时间(单位:小时) └ advanceBookingHour String 0.5 服务范围最短提前预定时间(单位:小时)，可传小时，30分钟传0.5
success	Boolean	true	是否成功
retCode	String	1001	错误码
retMessage	String	错误信息	错误信息

请求示例

{"traceId":"215045d716776565095286972e11b4","searchReq":{"storeCodeList":[""]}}

响应示例

{
    "searchResp":{
        "storeServiceList":[
            {
                    "storeCode":"1100",
                    "storeServiceRangeList":[
                        {
                                "rangeCode":"10",
                                "rangeName":"朝阳服务圈",
                                "isActive":true,
                                "rangeType":1,
                                "pickUpType":1,
                                "circleList":[
                                    {
                                            "longitude":"116.23232",
                                            "latitude":"39.52555",
                                            "radius":19999
                                    }
                                ],
                                "polygonList":[
                                    {
                                            "point":[
                                                {
                                                        "longitude":"116.23232",
                                                        "latitude":"39.23232"
                                                }
                                            ]
                                    }
                                ],
                                "serviceInfoList":[
                                    {
                                            "startTime":"08:00",
                                            "endTime":"22:00",
                                            "chargeType":0,
                                            "chargeFee":"30.00",
                                            "advanceBookingTime":1,
                                            "advanceBookingHour":"0.5"
                                    }
                                ]
                        }
                    ]
            }
        ]
    },
    "success":true,
    "retCode":"1001",
    "retMessage":"错误信息"
}

验签示例

{"success":"false","retMessage":"Illegal request","retCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

旅行用车API

qimen.alitrip.rentcar.store.range.info.query (同步门店服务范围信息数据)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ