概述
成品油价格受国家发改委调控，约每 10 个工作日调整一次。XAPI 提供四个互补的接口，覆盖从日常查询到调价预测的全场景：
| 接口 | 适用场景 | 计费 |
|---|---|---|
| oilprice.realtime | 查当前生效价 | 按次 |
| oilprice.all | 一次拉全量 | 按次 |
| oilprice.advance | 调价前 2 小时预知 | 按年 |
| oilprice.cycle | 当年调价日历 | 免费 |
三步拿到数据
- 到 注册页 注册并创建 API Key；
- 在请求头带上
X-API-Key: 你的Key； - 调用
/openapi/oilprice/realtime并传入省、市、区与油品名。
cURL
curl -s "https://api.xujian.tech/openapi/oilprice/realtime?province=重庆市&city=重庆市&district=铜梁区&oilName=0号柴油" \
-H "X-API-Key: 你的Key"计费与缓存建议
价格只在调价日变化，因此强烈建议先用免费的调价周期接口拿到当年的生效日期，只在调价日当天调用实时接口，其余时间使用本地缓存。这样既能保证数据新鲜，又能把按次调用量压到最低。
相关文章
同一分类或近期发布的更多内容。
技术思考
如何从零搭建一个 API 市场
把零散的数据与接口能力变成可计费、可分发的产品，中间要补齐鉴权、计费、限流与文档四块能力。本文结合 XAPI 的实践，给出一套可落地的拆分思路。
站点公告
欢迎来到 XAPI 技术博客
这里记录我们在 API 市场、成品油价格数据、行政区划与地址解析、OCR 与内容审核等方向的实践与思考，也会分享平台上线的新接口与对接经验。
API 详解
银行卡识别接口（bankcard.ocr）：卡号 + BIN + 发卡行等字段
bankcard.ocr 上传银行卡（卡号面）照片，一次返回卡号、卡号前 6 位 BIN、发卡行名称、卡类型、卡组织、卡等级、卡名称、持卡人姓名、有效期等字段，按次计费 0.05 元/次，调用即计费。
API 详解
身份证识别接口（idcard.ocr）：正反面 12 字段结构化
idcard.ocr 上传居民身份证（人像面或国徽面）照片，一次返回 12 个结构化字段：姓名、性别、民族、出生日期、住址、公民身份号码、签发机关、有效期等，并附置信度与图片质量提示，按次计费 0.05 元/次，调用即计费。
本系统其他接口
如果你正在调研能力接入，这些已上线的接口也许用得上。
企业信息模糊查询
按企业名称片段/注册号/统一社会信用代码模糊查询工商信息，返回企业名称、工商注册号、统一社会信用代码、企业类型（编码与中文）、成立日期与法定代表人；查得计费，未查询到结果、参数非法或上游不可用时不计费
enterprise.query
行政区划查询
免费接口，按行政区划代码/名称/拼音/省市区/邮编查询省市县（区）三级数据，数据每周日自动同步更新
region.query
自然语言地址解析
自然语言地址解析
address.parse
查询自己的公网IP
免费接口，返回调用方的公网IP地址，API Key 放在请求头 X-API-Key 中
ip.query
二手车信息查询
一次拉取批量二手车车源：车型名称、车辆图片、行驶里程、车辆标签、首付价格与注册年份，无需查询条件，支持limit控制条数；无车源返回时不计费
usedcar.list
实时发改委价格查询
按省（必填）、市、区与油品名查询当前生效的发改委成品油价格，返回商品名、生效日期与价格；未来生效的价格不会被查出
oilprice.realtime
