डेवलपर्स

iotBind पर बनाएँ

माइक्रोकंट्रोलर के लिए डिज़ाइन किए गए सरल API: एक URL, एक डिवाइस की और कुछ पैरामीटर।

HTTP / HTTPS

GET या POST अनुरोधों और JSON जवाबों से डेटा भेजें और पढ़ें।

MQTT

तुरंत कमांड के लिए अपने MQTT.one ब्रोकर से पब्लिश और सब्सक्राइब करें।

Webhooks

कुछ होने पर अपने सर्वर पर साइन की हुई सूचनाएँ पाएँ।

क्विक स्टार्ट

  1. 1

    अकाउंट बनाएँ

    मुफ़्त रजिस्टर करें और अपना ईमेल पता कन्फ़र्म करें।

  2. 2

    डिवाइस जोड़ें

    एक स्विच, सेंसर, टंकी या ट्रैकर जोड़ें, फिर यूनिक ID और सीक्रेट की कॉपी करने के लिए उसका की आइकन खोलें।

  3. 3

    अपना पहला अनुरोध भेजें

    नीचे दिए उदाहरण अपने स्केच में उपयोग करें या उन्हें अपने ब्राउज़र में टेस्ट करें।

बुनियादी बातें

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"}

GPS ट्रैकिंग

चार अतिरिक्त वैल्यू तक के साथ लोकेशन सहेजें, या नवीनतम लोकेशन पढ़ें।

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"}

MQTT

iotBind, MQTT.one सेवा के साथ काम करता है: डिवाइस बदलने पर प्लेटफ़ॉर्म आपके टॉपिक्स पर पब्लिश करता है, और आपके डिवाइस iotBind को JSON मैसेज पब्लिश करते हैं।

  1. एक MQTT.one अकाउंट बनाएँ और ज़रूरी टॉपिक्स जोड़ें।
  2. प्लेटफ़ॉर्म में "MQTT सेवा" खोलें और अपना MQTT.one अकाउंट लिंक करें।
  3. डिवाइस सेटिंग्स में "MQTT मैसेज पब्लिश करें" चालू करें और उसका टॉपिक चुनें।
  4. अपने MQTT.one विवरण के साथ, क्लाइंट ID iotbind-<UNIQUE_ID> का उपयोग करके अपने बोर्ड को ब्रोकर से कनेक्ट करें।
  5. अपने अकाउंट में दिखाए गए iotbind टॉपिक पर JSON मैसेज पब्लिश करें।
iotbind/switch/ टॉपिक पर मैसेज
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT के लिए MQTT फ़ीचर वाला प्लान और इस पर एक अकाउंट ज़रूरी है: MQTT.one

एरर कोड

400गलत अनुरोध: पता, पैरामीटर या बॉडी मान्य नहीं है।
401अनधिकृत: डिवाइस की या यूनिक ID गलत है।
404नहीं मिला: माँगा गया संसाधन मौजूद नहीं है।
429बहुत अधिक अनुरोध: गति धीमी करें, या अपने प्लान की सीमाएँ देखें।

आपका अगला प्रोजेक्ट एक क्लाउड का हक़दार है

एक मिनट में मुफ़्त अकाउंट बनाएँ और आज ही अपना पहला डिवाइस कनेक्ट करें।