ทดสอบ Cloud API ของ IAMMETER โดยใช้ Swagger UI

สรุปเอกสาร System API ของ IAMMETER

System API ของ IAMMETER มอบการเข้าถึงข้อมูลการตรวจสอบพลังงานจากอุปกรณ์ IAMMETER แบบเป็นโปรแกรมสำหรับนักพัฒนาและผู้ใช้ API นี้ถูกออกแบบมาเพื่อรวมความสามารถในการตรวจสอบพลังงานของ IAMMETER เข้ากับแอปพลิเคชันที่กำหนดเอง ระบบ IoT หรือแพลตฟอร์มของบุคคลที่สาม

เอกสารและการสนับสนุน

สำหรับข้อกำหนด API แบบละเอียด พารามิเตอร์ และตัวอย่าง โปรดดูที่เอกสารทางการ

ทุก API สามารถทดสอบได้โดยตรงที่นี่ /swaggerui

สำหรับความช่วยเหลือ โปรดใช้ https://imeter.club/

คุณสมบัติหลัก

การเข้าถึงข้อมูลแบบเรียลไทม์: ดึงข้อมูลการใช้พลังงานแบบเรียลไทม์ รวมถึงแรงดันไฟฟ้า กระแสไฟฟ้า กำลังไฟฟ้า และการใช้พลังงาน
ข้อมูลย้อนหลัง: เข้าถึงข้อมูลพลังงานย้อนหลังสำหรับการวิเคราะห์และการรายงาน
การจัดการอุปกรณ์: รับข้อมูลและสถานะของอุปกรณ์ เช่น เวอร์ชันเฟิร์มแวร์และการเชื่อมต่อ
การบูรณาการที่กำหนดเอง: รวมข้อมูลพลังงานเข้ากับระบบบ้านอัจฉริยะ แพลตฟอร์มการจัดการพลังงาน หรือแอปพลิเคชันอื่น ๆ ได้อย่างง่ายดาย

จุดสิ้นสุด API

รับข้อมูลแบบเรียลไทม์: ดึงข้อมูลเมตริกการใช้พลังงานล่าสุดจากอุปกรณ์
- ตัวอย่าง: GET /api/v1/realtime
- คืนค่า: ข้อมูลแรงดันไฟฟ้า กระแสไฟฟ้า กำลังไฟฟ้า และพลังงาน
รับข้อมูลย้อนหลัง: ดึงข้อมูลการใช้พลังงานในช่วงเวลาที่กำหนด
- ตัวอย่าง: GET /api/v1/historical?start=timestamp&end=timestamp
- คืนค่า: ข้อมูลการใช้พลังงานแบบรวม
รับข้อมูลอุปกรณ์: เข้าถึงรายละเอียดเกี่ยวกับอุปกรณ์ IAMMETER ที่เชื่อมต่อ
- ตัวอย่าง: GET /api/v1/deviceinfo
- คืนค่า: ID อุปกรณ์ เวอร์ชันเฟิร์มแวร์ และสถานะการเชื่อมต่อ

การรับรองความถูกต้อง

API ใช้การรับรองความถูกต้องแบบโทเค็น (token-based authentication) เพื่อความปลอดภัยในการเข้าถึง
รวมโทเค็น API ไว้ในส่วนหัวของคำขอ (request header) สำหรับการอนุญาต

ตัวอย่างการใช้งาน

การตรวจสอบแบบเรียลไทม์: แสดงการใช้พลังงานสดบนแดชบอร์ด
การรายงานพลังงาน: สร้างรายงานโดยใช้ข้อมูลย้อนหลัง
การบูรณาการบ้านอัจฉริยะ: ดำเนินการประหยัดพลังงานโดยอัตโนมัติตามข้อมูลแบบเรียลไทม์