API สาธารณะและการเชื่อมต่อ
ส่งกิจกรรมจากระบบ ERP และค่ามิเตอร์จาก IoT gateway เข้า CarbonBiz ผ่านอินเทอร์เฟซ OpenAPI 3.1 ที่มีเอกสารครบ พร้อม OAuth 2.0
ขอชมการสาธิตการกรอกด้วยมือไม่เหมาะกับองค์กรที่ข้อมูลกิจกรรมอยู่ในระบบ ERP อยู่แล้ว หรือไหลมาจากมิเตอร์ API สาธารณะเปิด CarbonBiz ให้ระบบเหล่านั้นเชื่อมต่อได้โดยไม่ผูกกับผู้ขายรายใด การยืนยันตัวตนใช้โทเค็น API ที่แฮชด้วย bcrypt และแสดงเต็มเพียงครั้งเดียวตอนสร้าง หรือใช้ OAuth 2.0 แบบ client credentials สำหรับการเชื่อมต่อระหว่างระบบ Webhook ให้ระบบภายนอกสมัครรับเหตุการณ์ โดยทุกการส่งลงนามด้วย HMAC SHA-256 และเก็บ signing secret แบบเข้ารหัส
ช่องทางรับข้อมูลมีสองแบบ ปลายทางรับกิจกรรมรับได้ทั้งรายการเดี่ยวและชุดละไม่เกิน 500 รายการจาก ERP โดยประมวลผลแบบบางส่วนเป็นค่าตั้งต้น แถวซ้ำจะถูกข้าม แถวที่ผิดพลาดจะรายงานว่าล้มเหลวขณะที่แถวอื่นสำเร็จ และคำนวณ CO2e ด้วยไลบรารีเดียวกับฟอร์มบนเว็บ ส่วนปลายทางรับค่ามิเตอร์รับข้อมูลอนุกรมเวลาจาก IoT gateway หรือมิเตอร์ปลายทาง แล้วรวมเป็นกิจกรรม Scope 2 อัตโนมัติ ทำให้ได้ข้อมูลไฟฟ้าแบบใกล้เวลาจริง
ทั้งสองช่องทางเป็น idempotent กิจกรรมถูกกันซ้ำด้วยรหัสอ้างอิงภายนอก และค่ามิเตอร์ด้วยรหัสมิเตอร์บวกเวลา การส่งซ้ำจึงไม่สร้างข้อมูลซ้ำ องค์กรถูกกำหนดจากโทเค็นเสมอ ไม่ใช่จากข้อมูลที่ส่งมา หน้าจัดการการเชื่อมต่อใช้จัดการโทเค็น ลงทะเบียนมิเตอร์ และดูบันทึกการรับข้อมูล ส่วนเอกสาร API สร้างอัตโนมัติเป็น OpenAPI 3.1 พร้อมตัวอย่างคำขอและคำตอบ
สิ่งที่ทำได้
- โทเค็น API (แฮชด้วย bcrypt) และ OAuth 2.0 client credentials
- Webhook ที่ลงนามด้วย HMAC SHA-256
- รับกิจกรรมจาก ERP รายการเดี่ยวหรือชุดละไม่เกิน 500 แบบประมวลผลบางส่วน
- ปลายทางรับค่ามิเตอร์ IoT รวมเป็นกิจกรรม Scope 2
- กันซ้ำแบบ idempotent หน้าจัดการการเชื่อมต่อ และเอกสาร OpenAPI 3.1