全量发改委价格查询接口（oilprice.all）：一次拿全部地区油价

这个接口能解决什么问题

如果你需要全量油价（做价格大屏、离线对账、批量成本核算、本地价格库初始化），一条一条调用实时接口既不经济也不现实。oilprice.all 一次把当前生效批次的全部价格明细整体返回，建议每天只拉取一次并在本地缓存。

一句话说明

oilprice.all 取生效日期小于等于今天的最新批次后整体返回，未来生效的价格不会被查出；数据量取决于运营维护粒度（全省统一价时约 30+ 条，按市维护时约 300+ 条）。

适用场景

本地价格库初始化：首次把全部地区油价落库
批量成本核算：按全国各地区油价做统一测算
油价监测大屏：展示全国价格分布
离线对账：与自有业务系统的价格做比对

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/oilprice/all`
请求方式	GET
鉴权方式	请求头 `X-API-Key`
接口编码	`oilprice.all`
收费类型	按次计费（PER_CALL，5.0000 元/次）
响应格式	JSON，`application/json（charset=UTF-8）`
典型用途	本地价格库初始化、批量核算、油价大屏、离线对账

如何调用

cURL

curl -s "https://api.xujian.tech/openapi/oilprice/all" -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",
      "updateTime": "2026-10-11 09:12:33"
    },
    {
      "province": "重庆市",
      "city": "重庆市",
      "district": "重庆市",
      "oilName": "92#汽油",
      "price": "7.55",
      "effectiveDate": "2026-10-11",
      "updateTime": "2026-10-11 09:12:33"
    }
  ],
  "apiCode": "oilprice.all",
  "apiName": "全量发改委价格查询",
  "chargeType": "PER_CALL",
  "balance": 95.0000,
  "costMs": 35
}

计费说明

按次计费，5.0000 元/次。因为一次返回全量数据，单价高于实时接口；配合调价周期（oilprice.cycle）做到「只在调价日拉一次」，可显著降低总体成本。

常见问题

返回多少条？ 取决于运营维护粒度：全省统一价约 30+ 条，按市维护约 300+ 条。
会返回未来生效的价格吗？ 不会，只返回当前生效批次。
多久拉一次合适？ 建议每天一次，或仅在调价日（见 oilprice.cycle）拉取。