实时发改委价格查询接口（oilprice.realtime）：查当前生效油价

这个接口能解决什么问题

成品油价格是物流、加油卡结算、油价展示类应用的刚需。oilprice.realtime 返回指定地区、指定油品「当前正在生效」的发改委价格：系统按生效日期分批维护，接口始终取生效日期小于等于今天的最新批次，未来生效的价格不会被查出。

一句话说明

按省（必填）+ 市 + 区 + 油品名（必填）查询当前生效油价；区未单独定价时自动回落到市级 / 省级统一价，避免查不到。

适用场景

油价展示：App / 小程序展示附近或指定地区的实时挂牌价
物流成本核算：按运输路径上的油价估算燃油成本
加油卡 / 会员结算：以官方发改委价为基准做差额核算
价格监测与比价：跟踪不同地区的成品油价格差异

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/oilprice/realtime`
请求方式	GET
鉴权方式	请求头 `X-API-Key`
接口编码	`oilprice.realtime`
收费类型	按次计费（PER_CALL，0.0100 元/次）
响应格式	JSON，`application/json（charset=UTF-8）`
数据更新	国家发改委约每 10 个工作日调价一次，运营调价当日维护入库
典型用途	油价展示、物流核算、加油卡结算、价格监测

如何调用

查询重庆市当前生效的 0#柴油价格（油品名含 # 号，建议用 --data-urlencode 编码）：

cURL

curl -s -G "https://api.xujian.tech/openapi/oilprice/realtime" --data-urlencode "province=重庆市" --data-urlencode "oilName=0#柴油" -H "X-API-Key: 你的APIKey"

返回示例（code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "province": "重庆市",
    "city": "重庆市",
    "district": "重庆市",
    "oilName": "0#柴油",
    "price": "7.05",
    "effectiveDate": "2026-10-11",
    "apiCode": "oilprice.realtime",
    "apiName": "实时发改委价格查询",
    "chargeType": "PER_CALL",
    "balance": 99.9900,
    "costMs": 20
  }
}

计费说明

按次计费，0.0100 元/次。每次成功返回当前生效价格计一次费用；参数缺失（如油品名或省份为空）等非法请求返回失败且不扣费。建议在客户端缓存当天结果，避免对同一地区重复拉取。

常见问题

为什么查不到某个区县的价格？ 区县若未单独定价，接口会自动回落到市级 / 省级统一价并返回，不会报错；若整个地区都没有维护数据，则返回失败（不计费）。
油品名怎么填？ 常见如「0#柴油」「92#汽油」「95#汽油」，请以平台维护的油品名称为准。
价格为什么偶尔不变？ 发改委约每 10 个工作日才调一次价，非调价日返回的是当前生效批次的价格。