接入文档
接口简介
本接口用于查询中国国内各省市的成品油(汽油、柴油)零售价格。开发者可通过传入特定日期,获取该日期对应的官方指导价或市场参考价,适用于需要集成能源成本数据的业务系统。
适用场景
- 物流运费计算:根据实时或历史油价动态调整运输成本估算。
- 出行服务应用:为车主提供加油成本参考及路线规划中的燃油预算。
- 数据分析平台:构建能源价格趋势图表,辅助行业研究与决策。
请求与返回说明
- 请求方法:POST
- 核心参数:
date(可选):查询日期,格式为yyyyMMdd(如20231001)。若不传,默认返回最新可用数据。- 返回结果:包含对应日期各标号油品(如92#、95#汽油,0#柴油等)的价格信息列表。
接入建议
- 缓存策略:油价调整频率较低(通常每10个工作日一次),建议对相同日期的查询结果进行本地缓存,减少不必要的API调用。
- 异常处理:请妥善处理非交易日或数据未更新时的返回情况,确保前端展示友好。
- 日期格式:务必严格遵守
yyyyMMdd格式传递日期参数,避免解析错误。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"date": "日期,格式:yyyyMMdd,比如:20220422,默认今日"
}响应示例
{}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.date | object | {...} |
| properties.date.type | string | string |
| properties.date.description | string | 日期,格式:yyyyMMdd,比如:20220422,默认今日 |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |