農機OpenAPI(株式会社クボタ、圃場農業機械)：devices/{device_id}/fuels
- 更新日 2024-10-21
概要
API名称
農機OpenAPI(株式会社クボタ、圃場農業機械)
説明
- 本APIでは、WAGRIのゲートウェイ機能を利用することにより、「農林水産データ管理・活用基盤強化事業」において策定された農機OpenAPI仕様に基づき株式会社クボタが準備した農機OpenAPIへの接続を提供します。
- 本APIを介して農機メーカAの農機OpenAPIへ接続し、次の情報を取得することができます。
- 登録済みの農業機械（トラクタ、コンバイン、田植機等）のリスト
- 農作業を通じて農業機械から取得した稼働データ等
- 農機OpenAPI仕様書への参照
農機OpenAPIの仕様を解説した農機OpenAPI仕様書の全文は次のリンク先で参照することができます。なお、農機OpenAPIの仕様に準拠した各APIの実装状況はサービス提供者によって異なりますので、下記の問い合わせ先でご確認下さい。
https://www.naro.affrc.go.jp/org/brain/iam/cluster/aboutus/API/index.html#specifications - 問い合わせ先
本APIの使用には、農業データ連携基盤（WAGRI）への利用登録と、株式会社クボタとの協議により利用契約等を締結する必要があります。利用を希望される方は、次にお問い合わせ願います。- 株式会社クボタ KSASサービスデスク (0120-527-800)
＜受付時間＞
月曜日～金曜日 9:00〜17:00 (12:00〜13:00を除く)
祝日と弊社指定の休日を除く
- 株式会社クボタ KSASサービスデスク (0120-527-800)
データの更新頻度
随時
カテゴリー
添付ファイル
ー
関連メソッド
リクエスト
URL
https://api.wagri.net/API/Individual/kubota/AgOpenAPI/farm_machinery/v1/devices/{device_id}/fuels
説明
デバイスに紐付けられた燃料消費データのリストを返却します。
- レコードの最大返却件数：1000件
- リクエストパラメータの fields, limit, sort は非サポートです。
- レスポンス項目の periodic_consumption は非サポートです。
- レコードのソート順：date_timeをキーに昇順でソートします。
- レコードデータの保存期間（遡ってデータ取得可能な期間）は12か月です。
詳細は農機OpenAPI仕様書を参照してください。
HTTPメソッド
GET
パラメータ
詳細は農機OpenAPI仕様書を参照してください。
呼出例
詳細は農機OpenAPI仕様書を参照してください。
レスポンス
レイアウト
詳細は農機OpenAPI仕様書を参照してください。
レスポンス例
詳細は農機OpenAPI仕様書を参照してください。
ステータスコード
| コード | 名称 | 値の説明 |
|---|---|---|
| 400 | Bad Request | リクエストが不正です。 |
| 401 | Unauthorized | 認証情報が不正です。 |
| 403 | Forbidden | リソースのアクセスが禁止されています。 |
| 500 | Internal Server Error | サーバー内部でエラーが発生しました。 |
サンプルソースコード
ソースコード
詳細は農機OpenAPI仕様書を参照してください。