提前查询发改委价格接口（oilprice.advance）：调价前 2 小时预知新价

这个接口能解决什么问题

油价在调价日 0 点切换，但加油站、物流、结算系统往往需要在切换前就把新价预置好。oilprice.advance 按「当前时间 + 2 小时」所在的日期取生效批次：若该批次晚于今天，说明查到的是即将生效的新价格（advance = true）；否则返回当前生效价格（advance = false）。无论哪种情况都会明确返回 effectiveDate。

一句话说明

oilprice.advance 让你在调价前 2 小时就拿到新价，提前完成系统预置与对账，避免调价日零点手忙脚乱。

适用场景

加油站调价预置：提前把新价写入收银 / 会员系统
物流报价提前测算：在调价前更新报价引擎
油价变动预警：监测即将生效的价格变化
调价日切换对账：对比新旧价格差异

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/oilprice/advance`
请求方式	GET
鉴权方式	请求头 `X-API-Key`
接口编码	`oilprice.advance`
收费类型	按年付费（YEARLY，360.0000 元/年，需后台授权）
响应格式	JSON，`application/json（charset=UTF-8）`
提前量	固定 2 小时（不可配置）
典型用途	加油站调价预置、物流报价测算、调价预警、切换对账

如何调用

需先联系平台完成按年授权；可只传省份缩小返回范围：

cURL

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

返回示例（查到即将生效的新价，code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "advance": true,
    "effectiveDate": "2026-10-25",
    "list": [
      { "province": "重庆市", "city": "重庆市", "district": "重庆市", "oilName": "0#柴油", "price": "7.12" },
      { "province": "重庆市", "city": "重庆市", "district": "重庆市", "oilName": "92#汽油", "price": "7.62" }
    ],
    "apiCode": "oilprice.advance",
    "apiName": "提前查询发改委价格",
    "chargeType": "YEARLY",
    "balance": 95.0000,
    "costMs": 22
  }
}

计费说明

按年付费，360.0000 元/年，需后台授权。授权有效期内不限调用次数，适合在调价窗口期频繁轮询。若系统中没有更新的价格，接口返回当前生效价格与生效开始时间（advance = false），同样不计额外费用。

常见问题

提前量能调大吗？ 固定 2 小时，不可配置；这是与发改委调价 0 点生效节奏对齐的设计。
没到调价日会返回什么？ 返回当前生效价格，advance = false，并带 effectiveDate 供你判断。
和普通实时接口有什么区别？ 实时接口只查当前生效价；advance 额外能在调价前 2 小时拿到新价。