POST公開中agricultural-products-price-list

地域別商品検索

利用料金

30 コイン/回

オンライン試用

コード不要、ブラウザから本物のリクエストを送信

導入ドキュメント

インターフェースの紹介

このインターフェイスは、製品名と地域名を使用した特定の日付の農産物市場価格データのクエリをサポートします。返される結果には、指定された地域の商品の最低価格、最高価格、平均価格、測定単位が含まれており、開発者が構造化された農産物市場情報を取得するのに役立ちます。

該当するシナリオ

農業電子商取引プラットフォーム: ユーザーの意思決定を支援するために、リアルタイムまたは過去の参考価格を表示します。
データ分析アプリケーション: 農産物の価格傾向グラフを作成し、地域の価格差を分析します。
サプライチェーン管理システム: 調達コストの変動を監視し、在庫と価格戦略を最適化します。

リクエストと返品の手順

リクエスト方法: POST
コアパラメータ:
productName (必須): 商品名。例: 「北海1号ハミメロン」。
region (必須): 地域名 (例: 「濰坊、山東省」)。
date (オプション): クエリ日付、形式 yyyy-MM-dd、デフォルトは現在の日です。
データを返す:
data.items: lowPrice (最低価格)、avgPrice (平均価格)、highPrice (最高価格)、unit (単位) およびその他のフィールドを含む価格リスト配列。
code: ステータスコード、200 は成功を意味します。

提案へのアクセス

パラメータ仕様: クエリのヒット率を向上させるために、受信地域名が製品標準名と正確に一致していることを確認してください。
キャッシュ戦略: 農産物価格の毎日の更新頻度は限られているため、繰り返しの呼び出しを減らすために、同じ地域の同じ日のクエリ結果を適切にキャッシュすることをお勧めします。
例外処理: データが返されない (項目が空である) 状況を処理し、フロントエンドでわかりやすいプロンプトを表示する必要があります。

実装サンプルコード

Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。

リクエスト例

{
  "productName": "商品名称",
  "region": "地区名称",
  "date": "日期，格式：yyyy-MM-dd，默认当天"
}

レスポンス例

{
  "code": 200,
  "msg": "成功",
  "taskNo": "192365493231988621883813",
  "data": {
    "count": 2,
    "items": [
      {
        "productName": "北海一号哈密瓜",
        "unit": "元/斤",
        "region": "山东潍坊",
        "date": "2026-05-06",
        "lowPrice": 0.9,
        "avgPrice": 0.9,
        "highPrice": 0.9
      },
      {
        "productName": "北海一号哈密瓜",
        "unit": "元/斤",
        "region": "山东潍坊",
        "date": "2026-05-06",
        "lowPrice": 0.9,
        "avgPrice": 0.9,
        "highPrice": 0.9
      }
    ]
  }
}

リクエスト項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
type	string	object
properties	object	{...}
properties.productName	object	{...}
properties.productName.type	string	string
properties.productName.description	string	商品名称
properties.region	object	{...}
properties.region.type	string	string

レスポンス項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
type	string	object
properties	object	{...}
properties.code	object	{...}
properties.code.type	string	number
properties.code.example	number	200
properties.code.description	string	返回码，详见返回码说明
properties.msg	object	{...}

curl --request POST \ --url 'https://openapi.toolkk.com/v1/agricultural-products-price-list' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "productName": "商品名称",\n "region": "地区名称",\n "date": "日期，格式：yyyy-MM-dd，默认当天"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/agricultural-products-price-list" payload = { "productName": "商品名称", "region": "地区名称", "date": "日期，格式：yyyy-MM-dd，默认当天" } 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())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/agricultural-products-price-list" payload := []byte("{\n \"productName\": \"商品名称\",\n \"region\": \"地区名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\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)) }

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 \"productName\": \"商品名称\",\n \"region\": \"地区名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/agricultural-products-price-list")) .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 $endpoint = 'https://openapi.toolkk.com/v1/agricultural-products-price-list'; $payload = "{\n \"productName\": \"商品名称\",\n \"region\": \"地区名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\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;