Tài liệu API

HƯỚNG DẪN TÍCH HỢP API - QRBOX

Hệ sinh thái thiết bị bật điện thông minh Điện Đồng Nai cung cấp hệ thống giao diện lập trình ứng dụng (RESTful API) mạnh mẽ, bảo mật cao, cho phép các đối tác phần mềm, chủ doanh nghiệp và lập trình viên dễ dàng tích hợp điều khiển thiết bị bật/tắt nguồn điện theo thời gian thực.

Thông tin cấp quyền API:

Để được cấp API Key và tài khoản Sandbox thử nghiệm tích hợp, vui lòng liên hệ Bộ phận Kỹ thuật Điện Đồng Nai qua Hotline: 0919 234 560.

API ĐIỀU KHIỂN CỔNG ĐIỆN (DEVICE CONTROL)

Dùng để bật, tắt và cấu hình thời gian cấp điện cho các cổng relay của thiết bị từ xa qua giao tiếp HTTP POST JSON.

Endpoint URL: https://control.diendongnai.com/api/device_control.php

Phương thức: POST  |  Content-Type: application/json

Headers yêu cầu:

Content-Type: application/json X-API-Key: <API_KEY_DUOC_CAP>

1. Bật nguồn điện theo thời gian (Hẹn giờ tự ngắt)

Áp dụng cho các mô hình tính phí theo thời lượng (ví dụ: bật cổng số 1 trong 600 giây = 10 phút). Sau khi đếm ngược hết thời gian cài đặt, hệ thống vi xử lý sẽ tự động ngắt relay bảo vệ an toàn:

{  "username": "<SO_DIEN_THOAI>",  "password": "<MAT_KHAU>",  "action": "on",  "mac": "<MAC_THIET_BI>",  "port": 1,  "duration_seconds": 600,  "request_id": "on-001" }

2. Bật nguồn điện không giới hạn thời gian (Bật liên tục)

Không truyền tham số duration_seconds. Cổng điện sẽ duy trì đóng tiếp điểm liên tục cho đến khi nhận được lệnh OFF từ server:

{  "username": "<SO_DIEN_THOAI>",  "password": "<MAT_KHAU>",  "action": "on",  "mac": "<MAC_THIET_BI>",  "port": 1,  "request_id": "on-002" }

3. Tắt nguồn điện (Ngắt cổng)

Gửi lệnh ngắt điện lập tức cho cổng được chỉ định:

{  "username": "<SO_DIEN_THOAI>",  "password": "<MAT_KHAU>",  "action": "off",  "mac": "<MAC_THIET_BI>",  "port": 1,  "request_id": "off-003" }

Lưu ý: Mỗi thao tác gửi lệnh mới cần sử dụng một request_id duy nhất (Unique ID). Nếu gửi lại (retry) cùng một yêu cầu do mạng chập chờn, hãy giữ nguyên request_id để hệ thống không thực thi trùng lặp.

CẦN HỖ TRỢ KỸ THUẬT & CẤP API KEY?

Đội ngũ kỹ sư Điện Đồng Nai luôn sẵn sàng hỗ trợ tích hợp và giải đáp mọi thắc mắc 24/7.

Hotline Kỹ thuật: 0919 234 560