调用价格
10 匠币/次
快速接入
保持统一返回结构，直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2cURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "date": "日期，格式：yyyyMMdd，比如：20220422，默认今日"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2"
payload = {
"date": "日期，格式：yyyyMMdd，比如：20220422，默认今日"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2"
payload := []byte("{\n \"date\": \"日期，格式：yyyyMMdd，比如：20220422，默认今日\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"date\": \"日期，格式：yyyyMMdd，比如：20220422，默认今日\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2';
$payload = "{\n \"date\": \"日期，格式：yyyyMMdd，比如：20220422，默认今日\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;响应示例
{}示例用于理解返回结构，实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
服务端调用时，将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求，并在 X-API-Key 请求头中传入密钥。
请求字段
字段来自接口结构定义。未提供的说明和示例会标为未标注。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| date | string | 否 | 日期，格式：yyyyMMdd，比如：20220422，默认今日 | 未标注 |
请求示例
{
"date": "日期，格式：yyyyMMdd，比如：20220422，默认今日"
}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
响应字段
示例用于理解返回结构，实际结果以接口返回为准。
暂无字段定义，请参考 JSON 示例与接口说明。
响应示例
{}接口简介
接口能力、应用场景、使用限制与常见问题。
接口能力
按日期查询数据源提供的国内地区油价参考，结果可包含省市名称、不同标号汽油及柴油价格。返回按地区组织的列表，适合在油价信息页展示多个地区的同日参考值。各标号应分别读取，不把地区名称相同或价差较小视为可以合并的同一种燃油。
应用场景
适合车主出行前查看地区油价、运输业务整理燃油成本资料，以及比较某一日期不同地区的参考价格。估算单次加油成本时，需要先确定燃油标号，再用每升参考价与预计加油升数计算；这一步由调用方完成。需要观察变化时，可以按明确日期保存返回快照，并保留日期，避免把历史价格当作今天的报价。
使用与结果解读
可按 yyyyMMdd 指定查询日期；未指定时按接口当前默认日期查询。读取列表后，将地区、燃油标号和单价一起展示。已核对的地区汽柴油价格采用元/升口径，例如单价 7.66 对应每升人民币 7.66 元；官方调价资料中另有元/吨表，两者不能混用。某地区某标号为空时保留缺失状态，不以其他标号或零值补齐。
范围与限制
地区油价参考不能代表每一家加油站的实际成交价。促销、服务形式、供应情况和更新时间可能造成差异；查询结果也不提供特定门店的库存或优惠信息。不同日期的结果应分别解读，历史查询是否有匹配数据以实际返回为准。成本估算需要明确升数和单价，并允许用加油站实际价格替换参考值。
常见问题
价格是每升还是每吨？
当前地区汽柴油单价按元/升解释；不要直接混用官方资料中的元/吨调价表。
能查询某个加油站优惠后的价格吗？
当前结果按地区和标号组织，不提供指定门店优惠成交价。
某标号为空是否表示免费或停售？
不能这样判断。空值表示本次未提供对应价格，应作为缺失处理。
如何核对历史日期？
按八位日期提交，并把查询日期与结果一起保存；无数据时保留无匹配状态。