淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
carUseTime	String	可选	2022-12-09 10:00	取车时间
traceId	String	可选	2147b26616704199973034110e3ca8	traceId
orderId	Number	可选	3074490435471203405	飞猪订单ID
isPressureTest	Boolean	可选	false	压测
outOrderId	String	可选	2212061862004534	商家订单ID
carReturnTime	String	可选	2022-12-09 12:30	还车时间
exts	String	可选	2147b26616704199973034110e3ca8	用于参数扩展

名称	类型	示例值	描述
success	Boolean	true	调用成功
retMessage	String	查询失败	错误原因
addedServiceList	AddedServiceList []		增值服务列表
└ serviceType Number 4 1-基础服务费(基本险-必传) 2-尊享服务费（不计免赔险） 3-其他保险 4-其他服务费 └ serviceDesc String 零散小时费增值服务描述 └ quantity String 1 增值服务数量 └ serviceCode String hourFee 商家增值服务编码 └ price String 10.25 增值服务单价(元) └ isOneWayFee Number 1 是否一口价，0-否，1-是。如果是一口价，即下单时候计算金额不会乘以天数。例如手续费等,价格以增值服务单价为准。 └ listInclude String [] 包含增值服务说明 └ amount String 0.25 增值服务总价 └ serviceName String 零散小时费增值服务名称 └ isFixed Number 1 是否必选服务必选服务不能取消 └ listExcloud String [] 不包含增值服务说明
cancelStrategyStruct	CancelStrategyStruct		取消政策（国内租车专用）
cancelRules CancelRules [] 具体取消收费规则。示例 "cancelRules":[{"num":0,"time":2},{"num":30.0,"time":0},{"num":100,"time":-999999}]表示用车前两小时取消不收违约金。两小时内收取30%的违约金。用车时间后取消收取100%的违约金 └ num Number 20 收取的取消费用，数字，单位与上述cancelType中设置的保持一致。 └ time Number 2 取车时间前time（单位：小时）取消用车，收取num费用 └ manualCheckTime Number 0 取消用车时，取车前多久时间取消需要商家进行人工审核，单位：小时。如果不需要人工审核，则该值设置为0，表示取车时间前都可直接取消。 └ cancelType Number 1 1-按照订单金额百分比收取取消费用，单位%。2-按照固定金额收取取消费用，单位：分 └ supportCancel Boolean true 是否支持取消，支持则按照以下规则填入。true-支持，false-不支持。 └ cancelTips String 补充说明取消补充说明
retCode	String	1001	错误码
priceInfo	BasicPriceInfo		车辆租金信息（国内租车专用）
└ quantity String 2 商家根据取还车时间计算租期，如 2.0、2.5 等 calendarPrice CalendarPrice [] 日租金详情列表 └ date String 2022-08-19 每日租期 └ dayPrice String 10.01 每日租金,单位:(元) └ scatteredMinutes Number 300 命中零散小时费规则的时长,单位:分钟 └ scatteredPrice String 368 命中零散小时费规则的价格,单位:元 scatteredPriceRuleInfo ScatteredPriceRuleInfo 零散小时费规则 data Data [] 零散小时费规则列表 └ startTime Number 60 开始分钟 └ endTime Number 120 结束分钟 └ value String 20 收费百分比，20 -> 20% └ standardPrice String 220.00 车辆租金总价（单价租期），下单时以此总数值为准，单价租期仅用于展示 └ basicServiceFee String 37.00 基础服务费,单位元 └ standardUnitPrice String 110.00 车辆租金单价，单位元。只能整数 └ poundageFee String 25.01 手续费,单位元 └ priceMark String 69831f0a61c7cdd42d102b2261210abf 商家价格标
insuranceStructInfo	InsuranceStructInfo		保险结构化信息，内层费项部分需与addedServiceList对应。eg：serviceCode需对应，若没对应则影响算价
insurances RentCarInsurance [] 租车保险类型 1-基础服务(基本险-必传) 2-优享服务（不计免赔险） 3-尊享服务, 99-其他保险 └ dailyUnitPrice String 2.00 优惠后保险每日单价，单位元 └ serviceCode String insurance-212 商家增值服务编码 └ originDailyUnitPrice String 2.00 保险每日单价,人民币，单位元 └ insuranceName String 基础服务保险名称 └ insuranceType Number 1 类型 1-基础服务(基本险-必传) 2-优享服务（不计免赔险） 3-尊享服务, 99-其他保险 insuranceItems InsuranceItem [] 此保险包含的项 └ subIncludes Number [] 不同项，包含的值是不一样，如果都有则把多个枚举传入，没有则不传 1:包含玻璃,2:包含车轮 └ include Boolean true 包含此内容项不包含项:null\|\|false 包含项:true └ name String 车损保障标题 └ from Number 1500 已废弃无需承担车损的起始金额,(元) e.g: 无需承担车损1500元-150万元的部分 1500为from └ to Number 1500000 已废弃无需承担车损的金额上限,(元) e.g: 无需承担车损1500元-150万元的部分 150万是该字段含义的具体值特殊的：若商家该保项无上限值，则传1500万作为上限 └ type Number 1 1：车损保障 2：三者保障 3：免折旧费 4：免停运费 5：无需垫付 └ percent Number 30 折旧费比例 e.g: 车损5000元以下，无需承担因车损导致的折旧费；超出部分需要承担维修总额的30%作为折旧费 30% 输入30 └ bounds Number 1500 起赔额或保额上限起赔额：用户自付的部分，保险公司只在超过这个部分时才赔偿。起赔额：保险公司承担的最高赔偿金额，超过这个金额的部分需要用户自负。 └ required Boolean false 是否必选，必选不能取消选择,false-非必选，true-必选 └ sid String 21 飞猪商家增值服务标准编码 11：车辆租金 12：零散小时费 13：手续费 14：商家优惠，传负值 21：基础服务 22：优享服务 23：尊享服务 24：其他保险服务费 31：送车上门服务费 32：上门还车服务费 33：异地还车费 34：夜间服务费 101：婴儿座椅（0~15个月） 102：儿童座椅（9个月~6岁） 103：儿童增高座垫（6~12岁） 111：防滑链 112：雪地胎 201：一口价活动 OTHER：其他费用

{"carUseTime":"2022-12-09 10:00","traceId":"2147b26616704199973034110e3ca8","orderId":0,"isPressureTest":false,"outOrderId":"2212061862004534","carReturnTime":"2022-12-09 12:30","exts":"2147b26616704199973034110e3ca8"}

{
    "success":true,
    "retMessage":"查询失败",
    "addedServiceList":[
        {
                "sid":"12",
                "serviceType":4,
                "serviceDesc":"零散小时费",
                "quantity":"1",
                "serviceCode":"hourFee",
                "price":"10.25",
                "isOneWayFee":1,
                "amount":"0.25",
                "serviceName":"零散小时费",
                "isFixed":1
        }
    ],
    "cancelStrategyStruct":{
        "cancelRules":[
            {
                    "num":20,
                    "time":2
            }
        ],
        "manualCheckTime":0,
        "cancelType":1,
        "supportCancel":true,
        "cancelTips":"补充说明"
    },
    "retCode":"1001",
    "priceInfo":{
        "quantity":"2",
        "calendarPrice":[
            {
                    "date":"2022-08-19",
                    "dayPrice":"10.01",
                    "scatteredMinutes":300,
                    "scatteredPrice":"368"
            }
        ],
        "scatteredPriceRuleInfo":{
            "data":[
                {
                        "startTime":60,
                        "endTime":120,
                        "value":"20"
                }
            ]
        },
        "standardPrice":"220.00",
        "basicServiceFee":"37.00",
        "standardUnitPrice":"110.00",
        "poundageFee":"25.01",
        "priceMark":"69831f0a61c7cdd42d102b2261210abf"
    },
    "insuranceStructInfo":{
        "insurances":[
            {
                    "dailyUnitPrice":"2.00",
                    "serviceCode":"insurance-212",
                    "originDailyUnitPrice":"2.00",
                    "insuranceName":"基础服务",
                    "insuranceType":1,
                    "insuranceItems":[
                        {,
                                "include":true,
                                "name":"车损保障",
                                "from":1500,
                                "to":1500000,
                                "type":1,
                                "percent":30,
                                "bounds":1500
                        }
                    ],
                    "required":false,
                    "sid":"21"
            }
        ]
    }
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

旅行用车API

qimen.alitrip.rentcar.renewalprices.query (续租报价查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ