家＆gt; 資力＆gt; ドキュメント＆gt; API で IAMMETER クラウドをより効率的に使用する方法

API で IAMMETER クラウドをより効率的に使用する方法

前提 APIの制限アカウント: アカウントのトークンを取得する URLとメソッドデータ応答 Webシステムから直接トークンを取得するエネルギーメーター: 最新のアップロードデータとUTC時間を取得します URLとメソッドパラメーター応答: 単相 -meterdata(力率なし) 応答: 単相 -meterdata2(力率なし) 応答: 3 相 - メーターデータ (力率なし) 応答: 3 相 -meterdata2(力率あり) 例エネルギーメーター: 履歴記録を取得する URLとメソッドパラメーター応答: 単相 - meterdatalist 応答: 三相 - meterdatalist 応答: 三相 - meterdatalist2 例エネルギーメーター: 電力読み取り分析 URLとメソッドパラメーター応答例エネルギーメーター: オフラインステータス分析 URLとメソッドパラメーター応答例アカウント: 1 つのアカウント内のすべてのエネルギーメーターから最新のデータを取得します URLとメソッドパラメーター応答例場所: 使用タイプごとに時間別または日別の kWh データを返します。 URLとメソッドパラメーター応答: 単相応答: 3段階リファレンス

前提

IAMMETER クラウドはいくつかの API を提供しており、開発者はこれらの API を使用して、IAMMETER のデータをサードパーティシステムに統合するなど、興味深い作業を行うことができます。以前はこれらの API をビジネスパートナーと一部の大口顧客に公開したばかりでしたが、現在はすべての顧客に公開することにしました。

フォーラムでご意見をお聞かせください。https://imeter.club

APIの制限

API は無制限にアクセスできるわけではありません。API ごとに 1 日の呼び出し回数を制限します。 API をより頻繁に呼び出さないでください。

呼び出し回数が時間単位または日単位の制限を超えた場合、API は何も返しません。

いいえ。	API	制限タイプ	1時間ごと	毎日	説明
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 回を超えないようにしてください。

URLとメソッド

すべての API で使用されるアカウントのトークンを取得します。

URL：https://www.iammeter.com/api/v1/user/login

方法：役職

データ

いいえ。	パラメータ	述べる	例
1	ユーザー名	IAMMETERのユーザー名	テスト
2	パスワード	IAMMETERのパスワード	123456

応答

トークン値は、以下のすべての API で使用されます。

{
    「データ」: {
        「ID」: 2025,
        「トークン」: 「349dfxxxxxxac5169」、
        "リフレッシュトークン": "8adf75e5da10424985f3b83855133982"
    }、
    「成功」: true、
    「メッセージ」: null
}

Webシステムから直接トークンを取得する

このトークンは、システムにログインした後に直接読み取ることもできます。

エネルギーメーター: 最新のアップロードデータとUTC時間を取得します

該当するSNで最後にアップロードしたデータを取得します。

この API を 1 時間に 12 回を超えて呼び出さないでください。

URLとメソッド

基本(メーターデータ): 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	必須

応答: 単相 -meterdata(力率なし)

値の定義: 電圧、電流、有効電力、インポートされた 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
}

応答: 単相 -meterdata2(力率なし)

値の定義: 電圧、電流、有効電力、力率、輸入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 相 - メーターデータ (力率なし)

の 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
}

応答: 3 相 -meterdata2(力率あり)

{
    "データ":{
        "値":[
            [//フェーズ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
}

例

エネルギーメーター: 履歴記録を取得する

設定された間隔と時間範囲の履歴データを返します。

期間: 最新の月
最大データ長：2000個

瞬時データは1分間隔です。 1 日あたり 60*24=1440 個のデータがあります。 1 分間隔で履歴データをリクエストする場合、1.39(2000/1440) 日分のデータのみリクエストできます。ただし、5 分間隔でデータをリクエストすると、ほぼ 7 日分のデータをリクエストできます。

URLとメソッド

基本(メーターデータリスト):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	必須

応答: 単相 - meterdatalist

データ:[電圧、電流、電力、エネルギーのインポート、エネルギーのエクスポート、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
}

応答: 三相 - meterdatalist

{
    「データ」: [
        [
            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
}

応答: 三相 - meterdatalist2

{
    "データ":[
        { //最初のデータ
            "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
}

例

https://www.iammeter.com/api/v1/Site/MeterDataList/{yourSN}?token={yourToken}&startTime=2023-09-01&endTime=2023-09-07&interval=300

エネルギーメーター: 電力読み取り分析

指定された時間内の電力解析結果を返します。

この API を 1 日に 5 回以上呼び出さないでください。

URLとメソッド

メールアドレス:https://www.iammeter.com/api/v1/site/powerAnalysis

方法：得る

限界: この API を SN ごとに毎日 5 回を超えてリクエストしないでください。

パラメーター

名前	タイプ	例
`スン`	弦	xxx	必須
`始まる時間`	弦	2023-09-01	オプション
`終了時間`	弦	2023-09-07	オプション

ノート：

最大期間は最新月の 7 日間です。
time パラメータはオプションです。パラメータを使用しない場合、API は過去 7 日間の結果を返します。

応答

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 日間の電力分析結果を返します。

指定した日の電力解析結果を返します

https://www.iammeter.com/api/v1/site/powerAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

エネルギーメーター: オフラインステータス分析

指定時間内の当該SNとの切断ステータスを返します。

この API を 1 日に 5 回以上呼び出さないでください。

URLとメソッド

メールアドレス：https://www.iammeter.com/api/v1/site/offlineAnalysis

方法：得る

限界: この API を SN ごとに毎日 5 回を超えてリクエストしないでください。

パラメーター

名前	タイプ	例
`スン`	弦	xxxx	必須
`始まる時間`	弦	2023-09-01	オプション
`終了時間`	弦	2023-09-07	オプション
`間隔`(単位：分)	番号	5	オプション

ノート：

最大期間は最新月の 7 日間です。
time パラメータはオプションです。パラメータを使用しない場合、API は過去 7 日間の結果を返します。
間隔を指定しない場合、デフォルトは 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
}

例

指定した日のオフライン解析結果を返す

https://www.iammeter.com/api/v1/site/offlineAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

アカウント: 1 つのアカウント内のすべてのエネルギーメーターから最新のデータを取得します

このアカウント内のすべてのエネルギーメーターの最新の値を返します。

URLとメソッド

メールアドレス：https://www.iammeter.com/api/v1/site/metersdata?token=xxx

方法：得る

限界: この API へのリクエストは 5 分に 1 回以上行わないようにしてください。

パラメーター

名前	タイプ	例
トークン	弦	xxx	必須

応答

{
"data":[
{
"sn":"DA2BED94",
"values":[
223.71,
1.74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"values":[
[
248.9,
13.9,
3356,
21228,
0,
null,
null
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
null,
null
],
[
null,
null,
null,
null,
null,
null
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
null,
null
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
「sn」:「674B1E5D」,
「値」:[
[
220.4,
1.86,
377,
5345.985,
20.565
],
[
220.4,
1.86,
377,
5367.715,
0.033
],
[
220.5,
1.86,
377,
5369.532,
0.033
]
],
「gmtTime」:「2024/2/22 3:45:50」 },
{
"sn":"59C9AB8D",
"values":[
[
245.3,
6.5,
1604,
46055.7,
0,
null,
null
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
null,
null
],
[
null,
null,
null,
null,
null,
null
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
null,
null
]
],
"gmtTime":"2024/2/22 3:45:15''
},
{
"sn":"3FE34ABE",
"values":[
[
230,
15.9,
3650.1,
2704.35,
0,
49.99,
0.94
],
[
230,
-11.5,
-2650.1,
1411.31,
1722.35,
49.99,
0.94
],
[
230,
4.3,
1000,
1946.03,
0,
49.99,
0.94
]
],
"gmtTime":"2024/2/22 3:46:01"
}
],
"成功":true,
"メッセージ":null
}

例

場所: 使用タイプごとに時間別または日別の kWh データを返します。

インバータ発電とグリッド交換（エクスポートとインポートの両方）の 1 時間ごと/ 1 日ごとの kWh 値を取得します。

URLとメソッド

メールアドレス：https://www.iammeter.com/api/v1/site/energyhistory/?始まる時間={2024-05-05}&終了時間={2024-07-07}&グループ化=&トークン={2be6d1xxxxxxcc688}

方法：得る

限界：

groupby = day :90日間のデータ（90個のデータ）

groupby = hour :7日間のデータ (168個のデータ)

パラメーター

名前	タイプ	デス	例
トークン	弦	アカウントのトークン	xxx	必須
場所ID	番号	場所のID		必須
始まる時間	弦	このAPIの戻りの開始時刻	2023-09-01	必須
終了時間	弦	このAPIの終了時刻を返します	2023-09-07	必須
グループ	列挙型	返されるデータ間隔(時間/日)を選択	日/時間	必須

場所ID: マイプレイス->編集

応答: 単相

場所ID:1360

開始時間=2024-05-05

終了時間=2024-05-07

グループ化=日

https://www.iammeter.com/api/v1/site/energyhistory/1360?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 9.62,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0,
"fromGrid": 9.16,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
「メッセージ」: null
}

応答: 3段階

場所ID:2393

開始時間=2024-05-05

終了時間=2024-05-07

グループ化=日

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0.1,
"fromGrid": 0.22,
"toGrid": 7.15,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true、
「メッセージ」: null
}

場所ID:2393

開始時間=2024-05-05

終了時間=2024-05-06

グループ化=時間

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 1:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 2:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
},
{
"time": "2024/5/5 3:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
},
{
"time": "2024/5/5 4:00:00"、
"yield": 0、
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 5:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 6:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 7:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 8:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 9:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
},
{
"time": "2024/5/5 10:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
},
{
"time": "2024/5/5 11:00:00"、
"yield": 0、
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 12:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 13:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 14:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 15:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 16:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
},
{
"time": "2024/5/5 17:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
},
{
"time": "2024/5/5 18:00:00"、
"yield": 0,
「fromGrid」: 0,
「toGrid」: 0,
「specialLoad」: 0,
「selfUse」: 0
},
{
「time」: 「2024/5/5 19:00:00」,
「yield」: 0,
「fromGrid」: 0,
「toGrid」: 0,
「specialLoad」: 0,
「selfUse」: 0
},
{
「time」: 「2024/5/5 20:00:00」,
「yield」: 0,
「fromGrid」: 0,
「toGrid」: 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 21:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 22:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 23:00:00"、
"yield": 0、
"fromGrid": 0、
"toGrid": 0、
"specialLoad": 0、
"selfUse": 0
}
]、
"successful": true、
"message": null
}