センシング情報変換API:sensor/{device_id}?RECEPTION_ID={RECEPTION_ID}
- 公開日
- 更新日 2024-11-19
利用条件
無償オプションAPI(申込必要)
概要
API名称
センシング情報変換API
カテゴリー
説明
センサーのデータをjson形式で送信すると、項目名をRightARM共通英名に変換するAPI。 対応するデバイスは以下の通り。
対応デバイス | device_id |
---|---|
あぐりログ | agri_log |
プロファインダー(ver.1) | profinder_v1 |
プロファインダー(ver.2) | profinder_v2 |
プロファインダー(ver.3) | profinder_v3 |
プロファインダー(ver.4) | profinder_v4 |
プロファインダーNext80 | profinder_next80 |
ゼロアグリ | zero_agri |
※その他 |
※ほかに対応しているデバイスもございますので、別途お問い合わせください。
■API使用方法
POSTメソッドにより、変換対象のデータ登録を行ってください。
受付ID(reception_id)が返却されますので、その受付IDを指定してGETメソッドをご利用いただきますと、変換結果を取得することができます。
※サンプルコードを公開していますので、ご参照ください。
APIの紹介 : センシング情報変換APIの利用サンプルコード
添付ファイル
ー
データの更新頻度
ー
リクエスト
新URL
New!
ー
旧URL(2025年度末で終了予定)
https://api.wagri.net/API/Individual/terasuma/SensorConverter/prd/v1/sensor/{device_id}?RECEPTION_ID={RECEPTION_ID}
説明
変換結果を取得するメソッド。
HTTPメソッド
GET
パラメータ
URLデータ定義
デバイスID
名称 | 型 | サイズ | 値の説明 |
---|---|---|---|
device_id | デバイスID。デバイスの種類を指定する。 | string | Required |
RECEPTION_ID | POSTメソッドによる変換対象センサーデータ登録時に返却されたreception_idをクエリストリングとして指定してください。 | string | Required |
URL説明
デバイスID/受付ID
新呼出例
New!
ー
旧呼出例2025年度末で終了予定)
https://api.wagri.net/API/Individual/terasuma/SensorConverter/prd/v1/sensor/{device_id}?RECEPTION_ID={RECEPTION_ID}
レスポンス
レイアウト
レスポンスデータ定義
変換対象データ登録メソッドレスポンス
名称 | 型 | サイズ | 値の説明 |
---|---|---|---|
200 OK | 正常に変換対象のセンサーデータ登録が完了しました。 | ||
400 Bad Request | リクエストの内容が不正です。リクエストデータを見直してください。 | ||
401 Unauthorized | 認証に失敗しました。認証情報が正しく設定されているかをご確認ください。 | ||
403 Forbidden | アクセス権限がありません。URLと認証情報が正しいかご確認ください。 | ||
500 Internal Server Error | サーバー内で予期せぬエラーが発生しました。ベンダーにお問い合わせください。 | ||
500 Internal Server Error | サーバー内で予期せぬエラーが発生しました。ベンダーにお問い合わせください。 |
レスポンス説明
変換結果取得メソッドレスポンス
レスポンス例
ー
ステータスコード
コード | 名称 | 値の説明 |
---|---|---|
400 | Bad Request | リクエストが不正です。 |
401 | Unauthorized | 認証情報が不正です。 |
403 | Forbidden | リソースのアクセスが禁止されています。 |
500 | Internal Server Error | サーバー内部でエラーが発生しました。 |
サンプルソースコード
プログラム記述例(WAGRI共通)
import requests url = "https://api.wagri.net/API/Public/AgriculturalLand/SearchByCityCode" payload = { 'CityCode': '432041' } headers = { 'X-Authorization': 'アクセストークン', } response = requests.get(url, headers=headers, params=payload) print(response.text)
プログラム記述例(個別API)
ー