Public API ERa hỗ trợ

Ghi chú

Swagger API E-ra https://backend.eoh.io/swagger/
Document API E-ra https://backend.eoh.io/redoc/

1. Hướng dẫn lấy mã AUTHTOKEN

Bước 1: Đăng nhập app.e-ra.io

Bước 2: Nhấp vào ảnh đại diện >> Chọn profile

Bước 3: Copy AUTHTOKEN

Lưu ý: Mã AUTHTOKEN là thông tin quan trọng, tuyệt đối không chia sẻ hoặc để lộ ra ngoài.

Khi đăng xuất tài khoản, nếu bạn chọn Đăng xuất khỏi tất cả thiết bị, mã AUTHTOKEN sẽ được khởi tạo lại.

2. Hướng dẫn cài đặt Authorizations trên swagger:

B1: Truy cập vào https://backend.eoh.io/swagger/ (Danh sách API của EoH)

B2: Điền mã AUTHTOKEN >> Nhấn Authorize >> Nhấn Close

B3: Như vậy là xong, bây giờ bạn có thể thực hành gọi các API có trong https://backend.eoh.io/swagger/

(Lưu ý thông tin AUTHTOKEN là thông tin quan trọng không được để lộ ra bên ngoài)

3. Hướng dẫn thực hành gọi một số API trên EoH

Cần cài đặt Authorizations trước khi thực hành.

Các hướng dẫn dưới đây có sử dụng các thuật ngữ như 'config', 'end device', v.v. Để hiểu rõ hơn về các thuật ngữ này, bạn có thể truy cập vào https://e-ra-iot-wiki.gitbook.io/documentation/huong-dan-su-dung-e-ra/thuat-ngu-can-quan-tam

3.1 Thực hành gọi API lấy giá trị hiện tại của config trên swagger

B1. Truy cập vào https://backend.eoh.io/swagger/. Tìm đến API GET `chip_manager/configs/`. Để lấy danh sách config bạn đang có. Sau đó nhấn vào "Try it out"

B2. Nhấn vào "Execute"

B3. Bạn sẽ nhận được dữ liệu trả về từ API `chip_manager/configs/` . Bao gồm nhiều thông tin của config vị dụ như id, name, unit, scale, ....

B4. Sử dụng API /chip_manager/configs/{id}/current_value/ Để nhận giá trị hiện tại của config. Từ B3 ở trên API `/chip_manager/configs/` đã trả về thông tin config id, ở đây mình lấy config id = 21973 làm ví dụ.

B5. Như vậy là xong từ việc gọi API /chip_manager/configs/{id}/current_value/
chúng ta đã có giá trị hiện tại của config current_value_only": 0

Một cách khác là sử dụng công cụ dòng lệnh CURL.

B1: Hãy kiểm tra xem CURL đã được cài đặt trên máy của bạn chưa bằng cách chạy lệnh `curl --version` trên terminal. Nếu không có thông báo lỗi nào xuất hiện, điều đó có nghĩa là CURL đã được cài đặt thành công. Ngược lại bạn cần tìm kiếm hướng dẫn cài đặt CURL trên mạng.

B2: Bạn copy dòng lệnh curl trên swagger và chạy nó trên terminal của bạn.

B3: Như vậy là xong từ việc sử dụng CURL chúng ta đã có giá trị hiện tại của config current_value_only": 0