農機OpenAPI:devices/{device_id}/operating_times
- 更新日 2024-10-21
概要
API名称
説明
・本APIでは、WAGRIのゲートウェイ機能を利用することにより、「農林水産データ管理・活用基盤強化事業」において策定された農機OpenAPI仕様に基づき三菱マヒンドラ農機株式会社が準備した農機OpenAPIへの接続を提供します。
・本APIを介して三菱マヒンドラ農機株式会社の農機OpenAPIへ接続し、次の情報を取得することができます。
・登録済み農業機械(トラクタ、コンバイン)のリスト
・農作業を通じて農業機械から取得した稼働データ等
・農機OpenAPI仕様書への参照
農機OpenAPIの仕様を解説した農機OpenAPI仕様書の全文は次のリンク先で参照することができます。
なお、農機OpenAPIの仕様に準拠した各APIの実装状況はサービス提供者によって異なりますので、下記の問合せ先でご確認下さい。
https://www.naro.affrc.go.jp/org/brain/iam/cluster/aboutus/API/index.html#specifications
・問い合わせ先
本APIの使用には、農業データ連携基盤(WAGRI)への利用登録と、三菱マヒンドラ農機株式会社との協議により利用契約等を締結する必要があります。
三菱マヒンドラ農機株式会社 https://www.mam.co.jp/
お問い合わせフォームよりご連絡ください。
データの更新頻度
カテゴリー
添付ファイル
リクエスト
URL
https://api.wagri.net/API/Individual/MAM/AgOpenApi/farm_machinery/v1/devices/{device_id}/operating_times
説明
デバイスに紐付けられた指定期間の稼働時間データのリストを返却する。
・本APIではリクエストパラメータのdevice_id、since、untill、limiitをサポートしています。
・詳細は農機API標準仕様書を参照してください。
HTTPメソッド
パラメータ
詳細は農機API標準仕様書を参照してください。
呼出例
詳細は農機API標準仕様書を参照してください。
レスポンス
レイアウト
詳細は農機API標準仕様書を参照してください。
レスポンス例
詳細は農機API標準仕様書を参照してください。
ステータスコード
コード | 名称 | 値の説明 |
400 | Bad Request | リクエストが不正です。 |
401 | Unauthorized | 認証情報が不正です。 |
403 | Forbidden | リソースのアクセスが禁止されています。 |
500 | Internal Server Error | サーバー内部でエラーが発生しました。 |
サンプルソースコード
ソースコード
詳細は農機API標準仕様書を参照してください。