家＆gt;
資力＆gt;
ドキュメント＆gt;
API で IAMMETER クラウドをより効率的に使用する方法
IAMMETER クラウドはいくつかの API を提供しており、開発者はこれらの API を使用して、IAMMETER のデータをサードパーティ システムに統合するなど、興味深い作業を行うことができます。 以前はこれらの API をビジネス パートナーと一部の大口顧客に公開したばかりでしたが、現在はすべての顧客に公開することにしました。
フォーラムでご意見をお聞かせください。https://imeter.club
API は無制限にアクセスできるわけではありません。API ごとに 1 日の呼び出し回数を制限します。 API をより頻繁に呼び出さないでください。
呼び出し回数が時間単位または日単位の制限を超えた場合、API は何も返しません。
| いいえ。 | API | 制限タイプ | 毎時 | 毎日 | 説明 |
|---|---|---|---|---|---|
| 1 | /ユーザー/ログイン | ip | 5 | 30 | 1 つの IP のみがこの API を 1 時間に 5 回呼び出すことが許可されます |
| 2 | /サイト/メーターデータ/ | SN | 12 | 1 つの SN のみがこの API を 1 時間に 12 回呼び出すことができます | |
| 3 | /site/powerAnalysis | SN | 5 | 1 つの SN のみがこの API を毎日 5 回呼び出すことができます | |
| 4 | /site/offline分析 | SN | 5 | 1 つの SN のみがこの API を毎日 5 回呼び出すことができます |
アカウントのトークンを返します。 トークンはほぼすべての API で使用されます。
トークンを更新する場合を除き、この API を呼び出す必要はありません。この API を呼び出す回数は 1 時間に 5 回を超えず、1 日に 30 回を超えないようにしてください。
すべての API で使用されるアカウントのトークンを取得します。
URL：https://www.iammeter.com/api/v1/user/login
方法：役職
| いいえ。 | パラメータ | 述べる | 例 |
|---|---|---|---|
| 1 | ユーザー名 | IAMMETERのユーザー名 | テスト |
| 2 | パスワード | IAMMETERのパスワード | 123456 |
トークン値は、以下のすべての API で使用されます。
{
「データ」: {
「ID」: 2025,
「トークン」: 「349dfxxxxxxac5169」、
"リフレッシュトークン": "8adf75e5da10424985f3b83855133982"
}、
「成功」: true、
「メッセージ」: null
}このトークンは、システムにログインした後に直接読み取ることもできます。
該当するSNで最後にアップロードしたデータを取得します。
この API を 1 時間に 12 回を超えて呼び出さないでください。
基本(メーターデータ): https://www.iammeter.com/api/v1/site/meterdata/{sn}
高度な(メーターデータ2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
方法： 得る
限界: この API を毎日 288 回 (5 分間隔) を超えてリクエストしないでください。
基本と上級の違い:
基本: PF(力率)なし
アドバンスト：PF(力率)あり
| 名前 | タイプ | 例 | |
|---|---|---|---|
| トークン | 弦 | xxx | 必須 |
値の定義: 電圧、電流、有効電力、インポートされた Kwh、エクスポートされた Kwh
{
「データ」: {
「値」: [
[
230.220、
1.300、
119.000、
1766.590、
0.000
】
]、
「ローカルタイム」: 「2020/8/28 15:27:33」、
「gmtTime」: 「2020/8/28 5:27:33」
}、
「成功」: true、
「メッセージ」: null
}値の定義: 電圧、電流、有効電力、力率、輸入Kwh、輸出Kwh
{
"データ":{
"値":[
[
233.41、
0.718、
111、
0.66、
5724.85、
0
】
]、
"ローカル時間": "2023/11/21 14:30:22"、
"gmtTime": "2023/11/21 6:30:22"
}、
「成功」: true、
「メッセージ」:null
}の 3 つの配列価値観はフェーズ A、フェーズ B、フェーズ C を表します。
要素定義: 電圧、電流、有効電力、力率、輸入Kwh、輸出Kwh
{
「データ」: {
「値」: [
[
242.600、
1.000、
216.000、
32354.600、
0.000
]、
[
242.600、
1.000、
1986.000、
30536.410、
17704.720
]、
[
0.000、
0.000、
0.000、
0.000、
0.000
】
]、
「ローカルタイム」: 「2020/8/28 15:30:48」、
「gmtTime」: 「2020/8/28 5:30:48」
}、
「成功」: true、
「メッセージ」: null
}{
"データ":{
"値":[
[//フェーズA
233.8,//電圧
0.03,//現在
4,//有効電力
0.57,//力率
222.53,//輸入Kwh
0 //エクスポートされた Kwh
]、
[//フェーズB
5、
0、
0、
0、
0、
0
]、
[ //フェーズC
3.1、
0、
0、
0、
0、
0
】
]、
"ローカル時間": "2023/11/21 14:39:36"、
"gmtTime": "2023/11/21 6:39:36"
}、
「成功」: true、
「メッセージ」:null
}
設定された間隔と時間範囲の履歴データを返します。
瞬時データは1分間隔です。 1 日あたり 60*24=1440 個のデータがあります。 1 分間隔で履歴データをリクエストする場合、1.39(2000/1440) 日分のデータのみリクエストできます。 ただし、5 分間隔でデータをリクエストすると、ほぼ 7 日分のデータをリクエストできます。
基本(メーターデータリスト):https://www.iammeter.com/api/v1/site/meterdatalist/
**詳細(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
基本と上級の違い:
基本: PF(力率)なし
アドバンスト：PF(力率)あり
| 名前 | タイプ | 例 | |
|---|---|---|---|
| トークン | 弦 | xxx | 必須 |
| 間隔 | 番号 | 300 | 必須、単位: 秒 |
| 始まる時間 | 弦 | 2023-09-01 | 必須 |
| 終了時間 | 弦 | 2023-09-07 | 必須 |
データ:[電圧、電流、電力、エネルギーのインポート、エネルギーのエクスポート、UTC 時間、現地時間]
{
「データ」: [
[
227.73、
1.45、
172、
13121.56、
0、
「2023/9/12 0:00:34」、
「2023/9/11 14:00:34」
]、
[
229.43、
1.45、
172、
13121.56、
0、
「2023/9/12 0:01:33」、
「2023/9/11 14:01:33」
】
]、
「成功」: true、
「メッセージ」: null
}{
「データ」: [
[
230,//A相電圧
0,//現在
0,//有効電力
468.41,//輸入kWh
0,//輸出kWh
230,//フェーズB
0、
0、
236.58、
290.77、
230,//フェーズC
0、
0、
258.62、
0、
「2023/9/12 0:00:15」、
「2023/9/11 16:00:15」
]、
[
230、
0、
0、
468.41、
0、
230、
0、
0、
236.58、
290.77、
230、
0、
0、
258.62、
0、
「2023/9/12 0:02:08」、
「2023/9/11 16:02:08」
】
]、
「成功」: true、
「メッセージ」: null
}{
"データ":[
{ //最初のデータ
"rtcTime": "2023/9/1 0:00:22"、
"gmtTime": "2023/8/31 16:00:22"、
"値":[
[ //フェーズA
235.2,//電圧
0.03,//現在
4,//有効電力
0.57,//力率
210.21,//Kwh をインポート
0 //エクスポートされた Kwh
]、
[//フェーズB
5.5、
0、
0、
0、
0、
0
]、
[ //フェーズC
3.3、
0、
0、
0、
0、
0
】
】
}、
{ //秒データ
"rtcTime": "2023/9/1 8:00:49"、
"gmtTime": "2023/9/1 0:00:49"、
"値":[
[
233.4、
0.03、
4、
0.57、
210.24、
0
]、
[
5.4、
0、
0、
0、
0、
0
]、
[
3.3、
0、
0、
0、
0、
0
】
】
}、
{ //3番目のデータ
"rtcTime": "2023/9/1 16:00:24"、
"gmtTime": "2023/9/1 8:00:24"、
"値":[
[
235.6、
0.03、
4、
0.57、
210.27、
0
]、
[
5.5、
0、
0、
0、
0、
0
]、
[
3.4、
0、
0、
0、
0、
0
】
】
}
]、
「成功」: true、
「メッセージ」:null
}
指定された時間内の電力解析結果を返します。
この API を 1 日に 5 回以上呼び出さないでください。
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
方法： 得る
限界: この API を SN ごとに毎日 5 回を超えてリクエストしないでください。
| 名前 | タイプ | 例 | |
|---|---|---|---|
すん |
弦 | xxx | 必須 |
始まる時間 |
弦 | 2023-09-01 | オプション |
終了時間 |
弦 | 2023-09-07 | オプション |
ノート：
Average: この時間範囲内の平均電力測定値。
AverageDaytime: この時間範囲内の平均日中 (午前 8:00 ～午後 8:00) の電力測定値。
minimum: この時間範囲内の最小パワー測定値。
最大: この時間範囲内の最大電力読み取り値。
{
「データ」: {
"startTime": "2023-09-01"、
"endTime": "2023-09-07"、
「平均」: 862.6、
「平均日中」: 836.9、
「最小」: 259.0、
「最大」: 3999.0
}、
「成功」: true、
「メッセージ」: null
}過去 7 日間の電力分析結果を返します。
指定した日の電力解析結果を返します
指定時間内の当該SNとの切断ステータスを返します。
この API を 1 日に 5 回以上呼び出さないでください。
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
方法：得る
限界: この API を SN ごとに毎日 5 回を超えてリクエストしないでください。
| 名前 | タイプ | 例 | |
|---|---|---|---|
すん |
弦 | xxxx | 必須 |
始まる時間 |
弦 | 2023-09-01 | オプション |
終了時間 |
弦 | 2023-09-07 | オプション |
間隔(単位：分) |
番号 | 5 | オプション |
ノート：
この時間範囲には合計 10080 分があります。
この時間範囲では、オフライン時間の合計は 906 分です。
5 分を超えるオフライン ギャップが配列にリストされます。
{
「データ」: {
"startTime": "2023-09-05"、
"endTime": "2023-09-11",
「オフライン数」: 906、
「合計数」: 10080、
「リスト」: [
{
"startTime": "2023/9/5 0:00:00",
「終了時刻」: 「2023/9/5 15:06:14」、
「期間」: 906
}
】
}、
「成功」: true、
「メッセージ」: null
}指定した日のオフライン解析結果を返す
