HTTP / HTTPS
GET या POST अनुरोधों और JSON जवाबों से डेटा भेजें और पढ़ें।
माइक्रोकंट्रोलर के लिए डिज़ाइन किए गए सरल API: एक URL, एक डिवाइस की और कुछ पैरामीटर।
GET या POST अनुरोधों और JSON जवाबों से डेटा भेजें और पढ़ें।
तुरंत कमांड के लिए अपने MQTT.one ब्रोकर से पब्लिश और सब्सक्राइब करें।
कुछ होने पर अपने सर्वर पर साइन की हुई सूचनाएँ पाएँ।
मुफ़्त रजिस्टर करें और अपना ईमेल पता कन्फ़र्म करें।
एक स्विच, सेंसर, टंकी या ट्रैकर जोड़ें, फिर यूनिक ID और सीक्रेट की कॉपी करने के लिए उसका की आइकन खोलें।
नीचे दिए उदाहरण अपने स्केच में उपयोग करें या उन्हें अपने ब्राउज़र में टेस्ट करें।
API वर्ज़न 1 का बेस पता http://api.iotbind.com/v1 है (HTTPS समर्थित है)। हर अनुरोध में ये पैरामीटर होते हैं, या तो क्वेरी स्ट्रिंग में (GET) या फ़ॉर्म फ़ील्ड के रूप में (POST):
| पैरामीटर | विवरण |
|---|---|
method | "get" or "post": पैरामीटर कैसे भेजे जाते हैं। हमेशा ज़रूरी। |
key | डिवाइस की सीक्रेट API की। हमेशा ज़रूरी। |
uid | डिवाइस की यूनिक ID। हमेशा ज़रूरी। |
डिवाइस की को गुप्त रखें। अगर यह लीक हो जाए, तो डिवाइस की आइकन से नई की बनाएँ: पुरानी की तुरंत काम करना बंद कर देती है।
स्विच को चालू या बंद करें, तीन वैल्यू तक सहेजें, या उसकी मौजूदा स्थिति पढ़ें।
GET | POST http://api.iotbind.com/v1/switch.php
| पैरामीटर | विवरण |
|---|---|
cmd |
वैकल्पिक कमांड: onoffgetping |
data1 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data2 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data3 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK
{"MESSAGE":"UPDATED"}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": ""
}
यही पैरामीटर POST फ़ॉर्म फ़ील्ड के रूप में भी काम करते हैं, इसके साथ method=post · डिवाइस कनेक्ट होने की सूचना देने के लिए भेजें cmd=ping → {"MESSAGE":"PING OK"}
तीन रीडिंग तक सहेजें, या नवीनतम वैल्यू पढ़ें।
GET | POST http://api.iotbind.com/v1/sensor.php
| पैरामीटर | विवरण |
|---|---|
cmd |
वैकल्पिक कमांड: getping |
data1 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data2 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data3 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012
{"MESSAGE":"UPDATED"}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"
}
यही पैरामीटर POST फ़ॉर्म फ़ील्ड के रूप में भी काम करते हैं, इसके साथ method=post · डिवाइस कनेक्ट होने की सूचना देने के लिए भेजें cmd=ping → {"MESSAGE":"PING OK"}
टंकी का स्तर और तापमान सहेजें, उसका पंप चालू-बंद करें, या उसकी स्थिति पढ़ें।
GET | POST http://api.iotbind.com/v1/tank.php
| पैरामीटर | विवरण |
|---|---|
cmd |
वैकल्पिक कमांड (टंकी का पंप चालू-बंद करता है): onoffgetping |
level |
टंकी का स्तर (संख्या)। |
temperature |
टंकी का वैकल्पिक तापमान (संख्या)। |
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21
{"MESSAGE":"UPDATED"}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"
}
यही पैरामीटर POST फ़ॉर्म फ़ील्ड के रूप में भी काम करते हैं, इसके साथ method=post · डिवाइस कनेक्ट होने की सूचना देने के लिए भेजें cmd=ping → {"MESSAGE":"PING OK"}
चार अतिरिक्त वैल्यू तक के साथ लोकेशन सहेजें, या नवीनतम लोकेशन पढ़ें।
GET | POST http://api.iotbind.com/v1/tracking.php
| पैरामीटर | विवरण |
|---|---|
cmd |
वैकल्पिक कमांड: getping |
latitude |
अक्षांश (संख्या)। |
longitude |
देशांतर (संख्या)। |
data1 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data2 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data3 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
data4 |
सहेजने के लिए वैकल्पिक टेक्स्ट या संख्या। |
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62
{"MESSAGE":"UPDATED"}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"
}
यही पैरामीटर POST फ़ॉर्म फ़ील्ड के रूप में भी काम करते हैं, इसके साथ method=post · डिवाइस कनेक्ट होने की सूचना देने के लिए भेजें cmd=ping → {"MESSAGE":"PING OK"}
iotBind, MQTT.one सेवा के साथ काम करता है: डिवाइस बदलने पर प्लेटफ़ॉर्म आपके टॉपिक्स पर पब्लिश करता है, और आपके डिवाइस iotBind को JSON मैसेज पब्लिश करते हैं।
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }
MQTT के लिए MQTT फ़ीचर वाला प्लान और इस पर एक अकाउंट ज़रूरी है: MQTT.one
400 | गलत अनुरोध: पता, पैरामीटर या बॉडी मान्य नहीं है। |
401 | अनधिकृत: डिवाइस की या यूनिक ID गलत है। |
404 | नहीं मिला: माँगा गया संसाधन मौजूद नहीं है। |
429 | बहुत अधिक अनुरोध: गति धीमी करें, या अपने प्लान की सीमाएँ देखें। |
एक मिनट में मुफ़्त अकाउंट बनाएँ और आज ही अपना पहला डिवाइस कनेक्ट करें।