การอ้างอิง API ภายในเครื่อง

API ภายในของเฟิร์มแวร์ IAMMETER

IAMMETER รองรับ HTTP API ในเครื่อง ดูเอกสารอย่างเป็นทางการสำหรับความสามารถของอุปกรณ์จริง เครื่องจำลองนี้ใช้งานเฉพาะชุดย่อยที่แสดงด้านล่าง

เอกสารประกอบ HTTP API ภายในของ IAMMETER

เส้นทางและเซสชัน

นำหน้าจุดสิ้นสุดมิเตอร์ทุกจุดด้วย /WEM3080, /WEM2067 หรือ /WEM3050T หน้าอุปกรณ์และ API รองรับ HTTP บนพอร์ต 80 เช่นเดียวกับ HTTPS บนพอร์ต 443 โดยปกติอุปกรณ์ทางกายภาพจะใช้ HTTP ในเครื่อง

คำขอการวัดสาธารณะทำงานโดยไม่มีเซสชันและส่งคืนแหล่งที่มา Inverter and grid เริ่มต้น การตั้งค่าส่วนตัวจำเป็นต้องมีคุกกี้หน้ามิเตอร์ที่มีอยู่ คำขอ Curl แยกต่างหากจะไม่สืบทอดแหล่งที่มาหรือการตั้งค่าที่เลือกของเบราว์เซอร์ของคุณ

HTTP และ HTTPS ใช้เซสชันเบราว์เซอร์แยกกัน เปิดหน้ามิเตอร์โดยใช้รูปแบบเดียวกันก่อนที่จะเปลี่ยนการตั้งค่า การอ่านแบบไม่ระบุชื่อใช้แหล่งที่มา Inverter and grid เริ่มต้น

รองรับชุดย่อย API ของเฟิร์มแวร์

วิธี	จุดสิ้นสุด	วัตถุประสงค์	รุ่นที่รองรับ
GET	/api/monitor	อ่านค่าแรงดัน กระแสไฟฟ้า กำลังและพลังงาน	ทุกรุ่น
GET	/api/monitorjson · /monitorjson	อ่าน JSON ดั้งเดิมพร้อมข้อมูลเชิงรับเพิ่มเติม	ทุกรุ่น
GET	/api/wifidata	อ่านการตั้งค่า Wi-Fi เสมือนและอุปกรณ์	ทุกรุ่น
POST	/api/setwifiadv	บันทึกการตั้งค่า Wi-Fi เสมือนสำหรับเซสชันและรุ่นนี้	ทุกรุ่น
GET	/api/getadv	อ่านการตั้งค่าขั้นสูงและอัพโหลด รหัสผ่านว่างเปล่า	ทุกรุ่น
POST	/api/setadv	บันทึกการตั้งค่าการอัปโหลด การตั้งค่าสถานะ Reactive และ NEM	ทุกรุ่น; NEM เฉพาะใน WEM3050T เท่านั้น

การตอบสนองของการวัด

WEM3080 ส่งคืน Data; WEM2067 และ WEM3050T ส่งคืน Datas โดยมีหนึ่งแถวต่อแชนเนล ลำดับฟิลด์แสดงอยู่ด้านล่าง ตัวอย่างเป็นเพียงภาพประกอบ ไม่ใช่การตอบกลับสด

ดัชนี	การวัด	หน่วย
0	แรงดันไฟฟ้า	V
1	กระแสไฟฟ้า	A
2	กำลังไฟฟ้าจริง	W
3	พลังงานไฟฟ้านำเข้า	kWh
4	พลังงานไฟฟ้าส่งออก	kWh
5	ความถี่	Hz
6	ตัวประกอบกำลัง	—

อ่านมาตรการสาธารณะ

curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'

รูปร่างตอบสนอง

{
  "ssid": "IAMMETER-Simulator",
  "sig": 100,
  "mac": "020000003050",
  "version": "simulator-1.0",
  "server": "em",
  "SN": "1AD9B537",
  "model": "WEM3050T",
  "Datas": [
    [230.0,1.252,270.0,2.092,0.000,50.00,0.94],
    [229.5,0.487,110.0,1.280,0.000,50.00,0.98],
    [229.0,0.399,90.0,0.747,0.000,50.00,0.98]
  ]
}

ตัวอย่าง JSON แบบเต็มและตารางการลงทะเบียน

การตั้งค่า Wi-Fi เสมือน

setwifiadv ยอมรับ ssid, pwd, dhcp (boolean), ip, netmask, gw และ dns ค่าเหล่านี้จะเปลี่ยนเฉพาะอุปกรณ์เสมือนเท่านั้น พวกเขาไม่ได้กำหนดค่าอะแดปเตอร์เครือข่ายใหม่

ตัวอย่างเนื้อหาคำขอ

{"ssid":"Test network","dhcp":true}

บันทึกสำเร็จ

{"successful":1,"message":"ok"}

การตั้งค่าขั้นสูง

setadv ยอมรับการอัปเดต JSON บางส่วน ช่องที่ไม่ได้ระบุจะเก็บค่าปัจจุบันไว้ ช่วงเวลาการอัปโหลดคือ 10–3600 วินาที

Reactive เพิ่ม EA.Reactive ให้กับ monitorjson และอัปโหลด ไม่ใช่ api/monitor แต่ละแถวคือ [var, inductive kvarh, capacitive kvarh]

NEM รองรับเฉพาะ WEM3050T เท่านั้น แถวที่สี่ของ Datas จะรวมกำลังที่ใช้งานอยู่ นำเข้า kWh และส่งออก kWh แยกกัน ฟิลด์อื่นๆ ทั้งหมดเป็นศูนย์

พารามิเตอร์	ค่าที่ยอมรับ
runMode	1 = TCP/TLS; 2 = HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone
uploadAddress	ที่อยู่ผู้รับ; ทำตามคำแนะนำอินพุต Settings
mqttUsername · mqttPassword	ข้อมูลประจำตัวของนายหน้า; getadv จะไม่ส่งคืนรหัสผ่านที่บันทึกไว้
uploadInterval	10–3600 วิ
reactive	0 / 1
netmetering	0 / 1
ntpServer	ข้อความที่เก็บไว้เท่านั้น ไม่เปลี่ยนเวลาเซิร์ฟเวอร์
haDiscovery · ctcRatio	เพียง 0 และ 1 ตามลำดับ ไม่มีการนำคุณสมบัติต่างๆ มาใช้

เปิดใช้งาน Reactive และ NEM บน WEM3050T

{"reactive":1,"netmetering":1}

กำลังตรวจสอบผลลัพธ์

บันทึกสำเร็จจะส่งคืน successful=1 ค่าการตั้งค่าที่ไม่ถูกต้องสามารถส่งคืน HTTP 200 ด้วย successful=0 ตรวจสอบ JSON รวมถึงรหัสสถานะ เซสชันที่หายไปส่งคืน 401; การเขียนข้ามต้นทางถูกปฏิเสธ

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

ไม่ได้ดำเนินการ

ฟังก์ชันด้านล่างเป็นแบบแสดงผลเท่านั้นหรือไม่รองรับ พวกเขาไม่ได้จัดเตรียม API การเขียนที่ใช้งานได้

การทำงาน	พฤติกรรมปัจจุบัน
สแกน Wi-Fi · รีสตาร์ท · รีเซ็ตเป็นค่าจากโรงงาน	ไม่มีการดำเนินการจริง
ความปลอดภัยของอุปกรณ์ · อัปเกรดเฟิร์มแวร์	แสดงผลเท่านั้น
IAMMETER-คลาวด์ · HA Discovery · ดาวน์ลิงก์ MQTT	ไม่มีการอัปโหลด การค้นพบ หรือการกำหนดค่าระยะไกลบนคลาวด์

การเลือกข้อมูลสถานการณ์

เครื่องมือจำลองได้รับการจัดทำเป็นเอกสารแยกต่างหาก

จุดสิ้นสุดการแก้ไขข้อบกพร่องของโปรแกรมจำลองไม่ใช่ API ของเฟิร์มแวร์ IAMMETER สิ่งเหล่านี้ไม่รวมอยู่ในรายการเฟิร์มแวร์ API ด้านบน

API การแก้ไขข้อบกพร่องของโปรแกรมจำลอง — ไม่ใช่ API ของเฟิร์มแวร์