บ้าน> ทรัพยากร> เอกสาร> ใช้ IAMMETER-cloud อย่างมีประสิทธิภาพมากขึ้นโดย API อย่างไร

ใช้ IAMMETER-cloud อย่างมีประสิทธิภาพมากขึ้นโดย API อย่างไร

ที่ตั้ง

IAMMETER-cloud มี API บางตัว และนักพัฒนาสามารถใช้ API เหล่านี้เพื่อทำงานที่น่าสนใจ เช่น การรวมข้อมูลของ IAMMETER เข้ากับระบบของบริษัทอื่นบางระบบ เราเพิ่งเปิด API เหล่านี้ให้กับพันธมิตรทางธุรกิจของเราและลูกค้ารายใหญ่บางรายมาก่อน แต่ตอนนี้ตัดสินใจเปิด API เหล่านี้ให้กับลูกค้าของเราทุกคนแล้ว

ยินดีต้อนรับสู่แจ้งให้เราทราบความคิดของคุณในฟอรัมของเราhttps://meter.club

ขีดจำกัดบน API

ไม่สามารถเยี่ยมชม API ได้ไม่จำกัด เราจะจำกัดจำนวนการโทรรายวันสำหรับแต่ละ API กรุณาอย่าเรียก API บ่อยกว่านี้

หากจำนวนการโทรเกินขีดจำกัดรายชั่วโมงหรือรายวัน API จะไม่ส่งคืนสิ่งใดเลย

เลขที่.	เอพีไอ	ประเภทขีด จำกัด	รายชั่วโมง	รายวัน	คำอธิบาย
1	/ผู้ใช้/เข้าสู่ระบบ	ไอพี	5	30	IP เดียวเท่านั้นที่ได้รับอนุญาตให้เรียก API นี้ 5 ครั้งต่อชั่วโมง
2	/ไซต์/ข้อมูลมิเตอร์/	ส.น	12		SN หนึ่งรายการได้รับอนุญาตให้เรียก API นี้ 12 ครั้งต่อชั่วโมงเท่านั้น
3	/ไซต์/powerAnalysis	ส.น		5	SN หนึ่งรายการได้รับอนุญาตให้เรียก API นี้ 5 ครั้งต่อวันเท่านั้น
4	/site/offlineAnalysis	ส.น		5	SN หนึ่งรายการได้รับอนุญาตให้เรียก API นี้ 5 ครั้งต่อวันเท่านั้น

รับโทเค็นของบัญชี

คืนโทเค็นของบัญชี โทเค็นจะถูกใช้ใน API เกือบทั้งหมด

คุณไม่จำเป็นต้องเรียก API นี้ เว้นแต่คุณต้องการรีเฟรชโทเค็นโปรดอย่าเรียก API นี้เกิน 5 ครั้งในหนึ่งชั่วโมง และไม่เกิน 30 ครั้งในหนึ่งวัน

URL&วิธีการ

รับโทเค็นของบัญชีที่ใช้ใน API ทั้งหมด

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

วิธี:โพสต์

ข้อมูล

เลขที่.	พารามิเตอร์	ข้อสังเกต	ตัวอย่าง
1	ชื่อผู้ใช้	ชื่อผู้ใช้ของ IAMMETER	ทดสอบ
2	รหัสผ่าน	รหัสผ่านของ IAMMETER	123456

การตอบสนอง

ค่าโทเค็นจะถูกใช้ใน API ทั้งหมดด้านล่าง

{
    "ข้อมูล": {
        "รหัส": 2025,
        "โทเค็น": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": null
}

รับโทเค็นจากระบบเว็บโดยตรง

โทเค็นนี้สามารถอ่านได้โดยตรงหลังจากที่คุณเข้าสู่ระบบ

รับข้อมูลการอัปโหลดล่าสุดและเวลา UTC

รับข้อมูลการอัปโหลดล่าสุดด้วย SN ที่คำนึงถึง

โปรดอย่าเรียก API นี้เกิน 12 ครั้งในหนึ่งชั่วโมง

URL&วิธีการ

พื้นฐาน (ข้อมูลมิเตอร์): https://www.iammeter.com/api/v1/site/meterdata/{sn}

ขั้นสูง (meterdata2): 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
            ]
        ],
        "เวลาท้องถิ่น": "28/2020/8/15:27:33",
        "gmtTime": "2020/8/28 5:27:33"
    },
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": 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"
    },
    "สำเร็จ":จริง,
    "ข้อความ":null
}

การตอบสนอง: 3 เฟส - ข้อมูลมิเตอร์ (ไม่มีตัวประกอบกำลัง)

ทั้งสามอาร์เรย์ในค่านิยมเป็นตัวแทนของเฟส A, เฟส B และเฟส C

คำจำกัดความขององค์ประกอบ: แรงดันไฟฟ้า, กระแส, พลังงานที่ใช้งาน,ตัวประกอบกำลังนำเข้า Kwh, ส่งออก Kwh

{
    "ข้อมูล": {
        "ค่า": [
            [
                242.600,
                1.000,
                216.000,
                32354.600,
                0.000
            ],
            [
                242.600,
                1.000,
                พ.ศ. 2529.000
                30536.410,
                17704.720
            ],
            [
                0.000,
                0.000,
                0.000,
                0.000,
                0.000
            ]
        ],
        "เวลาท้องถิ่น": "28/08/2020 15:30:48",
        "gmtTime": "2020/8/2020 5:30:48"
    },
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": null
}

การตอบสนอง: 3 เฟส -meterdata2(พร้อมตัวประกอบกำลัง)

{
    "ข้อมูล":{
        "ค่า":[
            [//เฟส ก
                233.8,//แรงดันไฟฟ้า
                0.03,//ปัจจุบัน
                4,//พลังที่ใช้งานอยู่
                0.57,//ตัวประกอบกำลัง
                222.53,//นำเข้ากิโลวัตต์
                0 //ส่งออก Kwh
            ],
            [//เฟสบี
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //เฟส C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "เวลาท้องถิ่น":"21/11/2023 14:39:36",
        "gmtTime":"2023/11/21 6:39:36"
    },
    "สำเร็จ":จริง,
    "ข้อความ":null
}

ตัวอย่าง

รับบันทึกประวัติศาสตร์

ส่งคืนข้อมูลประวัติตามช่วงเวลาและช่วงเวลาที่กำหนด

ช่วงเวลา: เดือนล่าสุด
ความยาวข้อมูลสูงสุด: 2,000 ชิ้น

ข้อมูลทันทีอยู่ในช่วง 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	ที่จำเป็น

การตอบสนอง: เฟสเดียว - รายการข้อมูลมิเตอร์

ข้อมูล:[แรงดันไฟฟ้า กระแสไฟฟ้า พลังงาน พลังงานนำเข้า พลังงานส่งออก เวลา 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"
        ]
    ],
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": null
}

การตอบสนอง: สามเฟส - รายการข้อมูลมิเตอร์

{
    "ข้อมูล": [
        [
            230,//แรงดันเฟสA
            0,//ปัจจุบัน
            0,//กำลังที่ใช้งานอยู่
            468.41,//นำเข้ากิโลวัตต์-ชั่วโมง
            0,//กิโลวัตต์ชั่วโมงที่ส่งออก
            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"
        ]
    ],
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": null
}

การตอบสนอง: สามเฟส - รายการข้อมูลมิเตอร์2

{
    "ข้อมูล":[
        { //ข้อมูลแรก
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "ค่า":[
                [ //เฟสก
                    235.2,//แรงดันไฟฟ้า
                    0.03,//ปัจจุบัน
                    4,//พลังที่ใช้งานอยู่
                    0.57,//ตัวประกอบกำลัง
                    210.21,//นำเข้ากิโลวัตต์
                    0 //ส่งออก Kwh
                ],
                [//เฟสบี
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //เฟส C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { // ข้อมูลที่สอง
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"1/9/2023 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
                ]
            ]
        },
        { // ข้อมูลที่สาม
            "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
                ]
            ]
        }
    ],
    "สำเร็จ":จริง,
    "ข้อความ":null
}

ตัวอย่าง

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

การวิเคราะห์การอ่านค่ากำลัง

ส่งคืนผลการวิเคราะห์กำลังตามเวลาที่กำหนด

โปรดอย่าเรียก API นี้เกิน 5 ครั้งในหนึ่งวัน

URL&วิธีการ

URL:https://www.iammeter.com/api/v1/site/powerAnalysis

วิธี: รับ

ขีดจำกัด: โปรดอย่าขอ API นี้ต่อ SN มากกว่า 5 ครั้งต่อวัน

พารามิเตอร์

ชื่อ	พิมพ์	ตัวอย่าง
`สน`	สตริง	xxx	ที่จำเป็น
`เวลาเริ่มต้น`	สตริง	2023-09-01	ไม่จำเป็น
`เวลาสิ้นสุด`	สตริง	2023-09-07	ไม่จำเป็น

บันทึก:

ช่วงเวลาสูงสุดคือ 7 วันในเดือนล่าสุด
พารามิเตอร์เวลาเป็นทางเลือก หากคุณไม่ได้ใช้พารามิเตอร์ API จะส่งกลับผลลัพธ์ของ 7 วันที่ผ่านมา

การตอบสนอง

เฉลี่ย: การอ่านกำลังเฉลี่ยในช่วงเวลานี้

ค่าเฉลี่ยเวลากลางวัน: การอ่านค่ากำลังในเวลากลางวันโดยเฉลี่ย (8:00 น.-20:00 น.) ในช่วงเวลานี้

ขั้นต่ำ: การอ่านค่าพลังงานขั้นต่ำในช่วงเวลานี้

สูงสุด: การอ่านค่ากำลังสูงสุดในช่วงเวลานี้

{
    "ข้อมูล": {
        "เวลาเริ่มต้น": "2023-09-01",
        "เวลาสิ้นสุด": "2023-09-07",
        "เฉลี่ย": 862.6,
        "เวลากลางวันเฉลี่ย": 836.9,
        "ขั้นต่ำ": 259.0,
        "สูงสุด": 3999.0
    },
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": null
}

ตัวอย่าง

ส่งคืนผลการวิเคราะห์กำลังของ 7 วันที่ผ่านมา

ส่งคืนผลการวิเคราะห์กำลังของวันที่ระบุ

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

การวิเคราะห์สถานะออฟไลน์

คืนสถานะการตัดการเชื่อมต่อด้วย SN ที่คำนึงถึงในเวลาที่กำหนด

โปรดอย่าเรียก API นี้เกิน 5 ครั้งในหนึ่งวัน

URL&วิธีการ

URL：https://www.iammeter.com/api/v1/site/offlineAnalysis

วิธี：รับ

ขีดจำกัด: โปรดอย่าขอ API นี้ต่อ SN มากกว่า 5 ครั้งต่อวัน

พารามิเตอร์

ชื่อ	พิมพ์	ตัวอย่าง
`สน`	สตริง	xxxx	ที่จำเป็น
`เวลาเริ่มต้น`	สตริง	2023-09-01	ไม่จำเป็น
`เวลาสิ้นสุด`	สตริง	2023-09-07	ไม่จำเป็น
`ช่วงเวลา`(หน่วย :นาที)	ตัวเลข	5	ไม่จำเป็น

บันทึก:

ช่วงเวลาสูงสุดคือ 7 วันในเดือนล่าสุด
พารามิเตอร์เวลาเป็นทางเลือก หากคุณไม่ได้ใช้พารามิเตอร์ API จะส่งกลับผลลัพธ์ของ 7 วันที่ผ่านมา
หากคุณไม่ระบุช่วงเวลา ค่าเริ่มต้นคือ 5 นาที

การตอบสนอง

ในช่วงเวลานี้มีทั้งหมด 1,0080 นาที

เวลาออฟไลน์ทั้งหมดคือ 906 นาทีในช่วงเวลานี้

ช่องว่างออฟไลน์ที่มากกว่า 5 นาทีแสดงอยู่ในอาร์เรย์

{
    "ข้อมูล": {
        "เวลาเริ่มต้น": "2023-09-05",
        "เวลาสิ้นสุด": "2023-09-11",
        "ออฟไลน์นับ": 906,
        "จำนวนรวม": 10080,
        "รายการ": [
            {
                "เวลาเริ่มต้น": "2023/9/5 0:00:00",
                "เวลาสิ้นสุด": "2023/9/5 15:06:14",
                "ระยะเวลา": 906
            }
        ]
    },
    "ประสบความสำเร็จ": จริง,
    "ข้อความ": null
}