POST已開放yjcx-oil-price-query-v2

油價查詢

接入文件

油價查詢

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

Shell 示例Python 示例Go 示例Java 示例PHP 示例

Shell 示例

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;

請求示例

{
  "date": "日期，格式：yyyyMMdd，比如：20220422，默认今日"
}

響應示例

{}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
type	string	object
properties	object	{...}
properties.date	object	{...}
properties.date.type	string	string
properties.date.description	string	日期，格式：yyyyMMdd，比如：20220422，默认今日

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
type	string	object

接入文件

接入示例程式碼

Shell 示例

Python 示例

Go 示例

Java 示例

PHP 示例

請求示例

響應示例

請求欄位

響應欄位

線上除錯