接口说明

通过本接口可查询燃油率

接口名称

pms.fuelRate.queryFuelRate

请求说明

请求内容	说明
URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，1000有需要可申请加大。

请求入参

名称	类型	必填	说明
productCode	String	Y	产品编码
startDate	Date	Y	燃油率起始时间
endDate	Date	Y	燃油率截止时间

请求示例

{
    "action": "pms.fuelRate.queryFuelRate",
    "app_key": "rebecca",
    "format": "json",
    "language": "zh_cn",
    "platform": "GFS",
    "sign": "00000000000000000000000000000000",
    "sign_method": "md5",
    "timestamp": "2021-08-18 001926",
    "version": "1.0",
    "data": {
        "productCode": "OSF811006991",
        "startDate": 1735660800000,
        "endDate": 1758189600000
    }
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

名称	类型	必传	说明	示例
productCode	String(32)	Y	查询的产品编码
needCalculateFuel	String(1)	Y	是否计算燃油：Y/N Y：是 N：否
fuelRateList	List	N	是否需要计算燃油返回“Y”时，返回的燃油率列表
– fuelRatePercentText	String(20)	Y	燃油率百分比例如：20.5%
– fuelRateStartDate	Date	Y	燃油率生效时间	2025-09-01 00:00:00
– fuelRateEndDate	Date	Y	燃油率过期时间为null时，表示当前生效，没有截止日期	2025-09-07 23:59:59
– updateTime	Date	Y	燃油率的记录的更新时间	2025-08-29 01:01:22

返回示例

{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "productCode": "OSF811006991",
        "needCalculateFuel": "Y",
        "fuelRateList": [
            {
                "fuelRatePercentText": "20.5%",
                "fuelRateStartDate": "2025-09-08 00:00:00",
                "fuelRateEndDate": null,
                "updateTime": "2025-09-05 01:02:15"
            },
            {
                "fuelRatePercentText": "20.25%",
                "fuelRateStartDate": "2025-09-01 00:00:00",
                "fuelRateEndDate": "2025-09-07 23:59:59",
                "updateTime": "2025-08-29 01:01:22"
            },
            {
                "fuelRatePercentText": "20.25%",
                "fuelRateStartDate": "2025-08-25 00:00:00",
                "fuelRateEndDate": "2025-08-31 23:59:59",
                "updateTime": "2025-08-22 01:00:45"
            }
        ]
    }
}

关键词