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 | অনেক বেশি রিকোয়েস্ট: গতি কমান, অথবা আপনার প্ল্যানের সীমা দেখুন। |
এক মিনিটে একটি বিনামূল্যের অ্যাকাউন্ট তৈরি করুন এবং আজই আপনার প্রথম ডিভাইস সংযুক্ত করুন।