Nhà phát triển

Xây dựng trên iotBind

API đơn giản, được thiết kế cho vi điều khiển: một URL, một khóa thiết bị và vài tham số.

Lấy khóa thiết bị Tài liệu API

HTTP / HTTPS

Gửi và đọc dữ liệu bằng yêu cầu GET hoặc POST với phản hồi JSON.

MQTT

Publish và subscribe qua broker MQTT.one của bạn để gửi lệnh tức thì.

Webhooks

Nhận thông báo có chữ ký trên máy chủ của riêng bạn khi có sự kiện xảy ra.

Bắt đầu nhanh

  1. 1

    Tạo tài khoản

    Đăng ký miễn phí và xác nhận địa chỉ email của bạn.

  2. 2

    Thêm thiết bị

    Thêm công tắc, cảm biến, bồn chứa hoặc thiết bị định vị, sau đó mở biểu tượng chìa khóa để sao chép ID duy nhất và khóa bí mật.

  3. 3

    Gửi yêu cầu đầu tiên

    Dùng các ví dụ bên dưới trong sketch của bạn hoặc thử ngay trên trình duyệt.

Cơ bản

Địa chỉ gốc của API phiên bản 1 là http://api.iotbind.com/v1 (hỗ trợ HTTPS). Mỗi yêu cầu đều mang các tham số sau, trong chuỗi truy vấn (GET) hoặc dưới dạng trường biểu mẫu (POST):

Tham sốMô tả
method"get" or "post": cách gửi tham số. Luôn bắt buộc.
keyKhóa API bí mật của thiết bị. Luôn bắt buộc.
uidID duy nhất của thiết bị. Luôn bắt buộc.

Hãy giữ bí mật khóa thiết bị. Nếu bị lộ, hãy tạo khóa mới từ biểu tượng chìa khóa của thiết bị: khóa cũ sẽ ngừng hoạt động ngay lập tức.

Công tắc

Bật hoặc tắt công tắc, lưu tối đa ba giá trị, hoặc đọc trạng thái hiện tại.

GET | POST http://api.iotbind.com/v1/switch.php

Tham sốMô tả
cmd Lệnh tùy chọn: onoffgetping
data1 Văn bản hoặc số tùy chọn để lưu.
data2 Văn bản hoặc số tùy chọn để lưu.
data3 Văn bản hoặc số tùy chọn để lưu.
Gửi dữ liệu 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK
Phản hồi: {"MESSAGE":"UPDATED"}
Đọc thiết bị 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Living room", "type": "RGB Light", "cmd": "on",
  "data1": "24.5", "data1_unit": "C", "data2": "OK", "data2_unit": "", "data3": "", "data3_unit": ""
}

Các tham số tương tự cũng dùng được dưới dạng trường biểu mẫu POST với method=post · Để báo thiết bị đang kết nối, hãy gửi cmd=ping → {"MESSAGE":"PING OK"}

Cảm biến

Lưu tối đa ba số liệu, hoặc đọc các giá trị mới nhất.

GET | POST http://api.iotbind.com/v1/sensor.php

Tham sốMô tả
cmd Lệnh tùy chọn: getping
data1 Văn bản hoặc số tùy chọn để lưu.
data2 Văn bản hoặc số tùy chọn để lưu.
data3 Văn bản hoặc số tùy chọn để lưu.
Gửi dữ liệu 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012
Phản hồi: {"MESSAGE":"UPDATED"}
Đọc thiết bị 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Greenhouse", "type": "Temperature",
  "data1": "23.4", "data1_unit": "C", "data2": "41", "data2_unit": "%", "data3": "1012", "data3_unit": "hPa"
}

Các tham số tương tự cũng dùng được dưới dạng trường biểu mẫu POST với method=post · Để báo thiết bị đang kết nối, hãy gửi cmd=ping → {"MESSAGE":"PING OK"}

Bồn chứa chất lỏng

Lưu mực và nhiệt độ bồn chứa, bật tắt máy bơm, hoặc đọc trạng thái.

GET | POST http://api.iotbind.com/v1/tank.php

Tham sốMô tả
cmd Lệnh tùy chọn (bật tắt máy bơm của bồn): onoffgetping
level Mực bồn chứa (số).
temperature Nhiệt độ bồn chứa, tùy chọn (số).
Gửi dữ liệu 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21
Phản hồi: {"MESSAGE":"UPDATED"}
Đọc thiết bị 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Roof tank", "type": "Water Level", "cmd": "on",
  "level": "67", "level_unit": "%", "temperature": "21", "temperature_unit": "C"
}

Các tham số tương tự cũng dùng được dưới dạng trường biểu mẫu POST với method=post · Để báo thiết bị đang kết nối, hãy gửi cmd=ping → {"MESSAGE":"PING OK"}

Định vị GPS

Lưu vị trí kèm tối đa bốn giá trị bổ sung, hoặc đọc vị trí mới nhất.

GET | POST http://api.iotbind.com/v1/tracking.php

Tham sốMô tả
cmd Lệnh tùy chọn: getping
latitude Vĩ độ (số).
longitude Kinh độ (số).
data1 Văn bản hoặc số tùy chọn để lưu.
data2 Văn bản hoặc số tùy chọn để lưu.
data3 Văn bản hoặc số tùy chọn để lưu.
data4 Văn bản hoặc số tùy chọn để lưu.
Gửi dữ liệu 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62
Phản hồi: {"MESSAGE":"UPDATED"}
Đọc thiết bị 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Car", "type": "GPS tracking",
  "latitude": "24.7136", "longitude": "46.6753", "data1": "62", "data1_unit": "km/h"
}

Các tham số tương tự cũng dùng được dưới dạng trường biểu mẫu POST với method=post · Để báo thiết bị đang kết nối, hãy gửi cmd=ping → {"MESSAGE":"PING OK"}

MQTT

iotBind hoạt động với dịch vụ MQTT.one: nền tảng publish lên các topic của bạn khi thiết bị thay đổi, và thiết bị của bạn publish tin nhắn JSON lên iotBind.

  1. Tạo tài khoản MQTT.one và thêm các topic bạn cần.
  2. Trên nền tảng, mở "Dịch vụ MQTT" và liên kết tài khoản MQTT.one.
  3. Trong cài đặt thiết bị, bật "Publish tin nhắn MQTT" và chọn topic.
  4. Kết nối bo mạch với broker bằng thông tin MQTT.one của bạn, dùng client ID iotbind-<UNIQUE_ID>.
  5. Publish tin nhắn JSON lên topic iotbind hiển thị trong tài khoản của bạn.
Tin nhắn gửi đến topic iotbind/switch/ 
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT yêu cầu gói có tính năng MQTT và một tài khoản tại MQTT.one

Mã lỗi

400Yêu cầu không hợp lệ: địa chỉ, tham số hoặc nội dung không hợp lệ.
401Không được phép: khóa thiết bị hoặc ID duy nhất không đúng.
404Không tìm thấy: tài nguyên được yêu cầu không tồn tại.
429Quá nhiều yêu cầu: hãy giảm tốc độ hoặc kiểm tra giới hạn gói của bạn.

Dự án tiếp theo của bạn xứng đáng có một nền tảng đám mây

Tạo tài khoản miễn phí trong một phút và kết nối thiết bị đầu tiên ngay hôm nay.

Tạo tài khoản miễn phí Trò chuyện với chúng tôi