使い方


1. ユーザー情報とCH情報を取得

(1) ログイン

https://envelopa1.fluunt.club/

  • 事前通知されたUserNameとPasswordでログイン

(2) 情報を参照

  • 1: User Name User Key
  • user key: <user key char: 36Byte char>
  • 2: Channels Info
  • 取得したいCHのchannel name, channel id, read key ( write key )をメモ
  • channel id: <char>
  • read key: <read key char: 36Byte char>

2. API

2-1 read

(1) 最新の1つの情報の取得

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&n=1"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

結果

[{"mac":"XXXXXCD7650F","temperature":27.55,"label1":"Temperature","humidity":0.34,"label2":"Humidity","battery":3.09,"label3":"Batt","hdate":"2025-01-07 17:47:13"}]

(2) 最新の10の情報の取得、Skip5の場合

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&n=10&skip=5"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

結果

  • センサータグごとに5飛ばしで10件が表示される
  • 注意:結果出力は最大5000件まで

参考 Skip無しn-10

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&n=10"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

(3) 日付指定

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&date=2025-1-6"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

注意:結果出力は最大5000件まで

(4) 期間指定

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&start=2024-12-31%2000:00:01&end=2025-01-6%2023:59:59"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

注意:日付と時間の間の空白はURLエンコードするため%20となる

空白は%20にエンコードする。以下はエラーとなる。

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&start=2024-12-31 00:00:01&end=2025-01-6 23:59:59"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

2-2 getproc

Channel情報を取得する。

curl -X GET "https://envelopa1.fluunt.club/api/getprop/?cid=<channel id>" \
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"

2-3 コメントの書き換え

curl -X PUT "https://envelopa1.fluunt.club/api/putcmd/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "ukey: <user key char>" \
-H "wkey: <write key char>" \
-d "cid=<channel id>&mac=XXXXCD765YY&label1=Korega Jyuuyou&start=2025-01-07%2017:22:00&end=2025-01-07%2017:22:59"

注意:macを正しく指定する。時間をただしく指定する。

確認

curl -X GET "https://envelopa1.fluunt.club/api/read/?cid=<channel id>&start=2025-01-07%2017:22:00&end=2025-01-07%2017:22:59"\
 -H "rkey: <read key char>" \
 -H "ukey: <user key char>"