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

qimen.alitrip.rentcar.store.base.info.query (同步门店基础信息数据)

商品库拉取信息-门店数据拉取；飞猪每天定时调用此接口按照供应商城市Code分批拉取API供应商所有门店信息；门店信息为必传。

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	描述
searchReq	SearchReq	必须		搜索参数
└ cityCodeList String [] 必须供应商CityCode列表，需要传递对应城市的门店信息
traceId	String	必须	215045d716776565095286972e11b4	raceId

响应参数

名称	类型	示例值	描述
searchResp	SearchResp		搜索结果
storeInfoList StoreInfo [] 门店信息（所有无效有效门店都传） └ storeCode String 1100 供应商门店Code,保证唯一 └ companyCode String 122 门店对应的公司Code(针对自营商家不读取此字段) └ cityCode String 110000 门店所在市的供应商cityCode └ storeName String 一号门店门店名称 └ parentStoreCode String 1100 供应商父门店code, 仅当storeType不为1时有效 └ storeType Number 1 门店类型, 1:门店 2:提车点 └ address String 北京市东城区门店地址 └ longitude String 116.23232 门店经度，依照高德经纬度格式，精确到小数点后5位即可 └ latitude String 39.52525 门店纬度，依照高德经纬度格式，精确到小数点后5位即可 └ contact String 张三门店联系人 └ phone String 15078787878 门店联系电话，11位整数 └ rentIntervalTime Number 1 同辆车租赁间隔(单位:小时，整数) └ advanceBookingTime Number 1 （已废弃）门店最短提前预定时间(单位:小时,整数) └ advanceBookingHour String 1.5 门店最短提前预定时间(单位:小时,可传小数如：0.5) └ maxLeaseTime Number 24 最大租赁时间，单位小时，整数 └ minLeaseTime Number 4 最小租赁时间，单位小时，整数 └ isActive Boolean true 门店是否有效，true为有效，false表示无效，商家确保将所有门店数据同步给平台（有效，无效） storeOpenTimeList StoreOpenTime [] 门店营业时间，不可为空，各个营业时间之间不可重叠 └ chargeType Number 1 收费方式 1:收费 2:免费 └ chargeFee String 30.00 营业时间段总价格精确到2位小数;单位:元。如：200.07，表示：200元7分，仅当chargeType为1时有效 └ startTime String 08:00 开始时间,格式为HH:mm └ endTime String 10:00 结束时间,格式为HH:mm └ effectWeek String 1,2,3 表示在每周的星期几生效,周一到周日依次为1...7，多个使用逗号分隔 storeCloseTimeList StoreCloseTime [] 门店非营业时间,如果为空则表示无非营业时间 └ startTime String 2024-08-23 00:00:00 停止营业时间开始时间,格式为yyyy-MM-dd HH:mm:ss └ endTime String 2024-08-24 00:00:00 停止营业时间结束时间,格式为yyyy-MM-dd HH:mm:ss diffStoreInfoList DiffStoreInfo [] 异地还车配置 └ diffStoreCode String 1001 异地还车门店Code(当前门店可还车到的异地门店Code) └ diffStoreOwnerType Number 1 车辆归属类型，1-归属到当前门店(异地还车结束后，将车辆调度回取车门店)，2-归属到异地门店(异地还车结束后，将车辆留在还车门店) └ isActive Boolean true 是否激活，true激活，false不激活 └ diffStoreIntervalTime Number 1 异地还车后的租赁间隔，单位小时，整数
success	Boolean	true	是否成功
retCode	String	1001	错误码
retMessage	String	错误信息	错误信息

请求示例

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

响应示例

{
    "searchResp":{
        "storeInfoList":[
            {
                    "storeCode":"1100",
                    "companyCode":"122",
                    "cityCode":"110000",
                    "storeName":"一号门店",
                    "parentStoreCode":"1100",
                    "storeType":1,
                    "address":"北京市东城区",
                    "longitude":"116.23232",
                    "latitude":"39.52525",
                    "contact":"张三",
                    "phone":"15078787878",
                    "rentIntervalTime":1,
                    "advanceBookingTime":1,
                    "advanceBookingHour":"1.5",
                    "maxLeaseTime":24,
                    "minLeaseTime":4,
                    "isActive":true,
                    "storeOpenTimeList":[
                        {
                                "chargeType":1,
                                "chargeFee":"30.00",
                                "startTime":"08:00",
                                "endTime":"10:00",
                                "effectWeek":"1,2,3"
                        }
                    ],
                    "storeCloseTimeList":[
                        {
                                "startTime":"2024-08-23 00:00:00",
                                "endTime":"2024-08-24 00:00:00"
                        }
                    ],
                    "diffStoreInfoList":[
                        {
                                "diffStoreCode":"1001",
                                "diffStoreOwnerType":1,
                                "isActive":true,
                                "diffStoreIntervalTime":1
                        }
                    ]
            }
        ]
    },
    "success":true,
    "retCode":"1001",
    "retMessage":"错误信息"
}

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

旅行用车API

qimen.alitrip.rentcar.store.base.info.query (同步门店基础信息数据)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ