農機OpenAPI：devices/{device_id}/locations
- 更新日 2024-10-21
概要
API名称
農機OpenAPI(井関農機株式会社)
説明
- 本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）への利用登録と、井関農機株式会社との協議により利用契約等を締結する必要があります。利用を希望される方は、次にお問い合わせ願います。- 井関農機株式会社 問い合わせ先：h-nouki@iseki.co.jp
データの更新頻度
随時
カテゴリー
添付ファイル
ー
関連メソッド
リクエスト
URL
https://api.wagri.net/API/Individual/iseki/AgOpenApi/farm_machinery/v1/devices/{device_id}/locations
説明
デバイスに紐付けられたロケーションレコードのリストを返却する。
- 本APIではリクエストパラメータのsince,untilのみサポートしています。
- 詳細は農機API標準仕様書を参照してください。
HTTPメソッド
GET
パラメータ
- 詳細は農機API標準仕様書を参照してください。
呼出例
- 詳細は農機API標準仕様書を参照してください。
レスポンス
レイアウト
- 詳細は農機API標準仕様書を参照してください。
レスポンス例
- 詳細は農機API標準仕様書を参照してください。
ステータスコード
| コード | 名称 | 値の説明 |
|---|---|---|
| 400 | Bad Request | リクエストが不正です。 |
| 401 | Unauthorized | 認証情報が不正です。 |
| 403 | Forbidden | リソースのアクセスが禁止されています。 |
| 500 | Internal Server Error | サーバー内部でエラーが発生しました。 |
サンプルソースコード
ソースコード
- 詳細は農機API標準仕様書を参照してください。