API

Input

Fiecare senzor inregistrat in sistem este identificat pe baza unui token, un sir de caractere lung, generat in mod unic pentru fiecare senzor. Pentru a trimite date catre iot.robofun.ro aveti nevoie de token-ul asociat senzorului pentru care doriti sa inregistrati date. Acest token il gasiti in pagina de setari a fiecarui senzor. Obtineti adresa web catre care trebuie sa trimiteti datele folosind token-ul, ca mai jos :

				http://iot.robofun.ro/api/v1/senzor/[aici_introduceti_tokenul_senzorului]/input?value=10.4
			

Pentru a inregistra date in sistem pentru senzorul respectiv, este suficient un simplu apel GET catre serverul iot.robofun.ro. Mai jos gasiti cateva exemple :

Folosind curl:

				curl -X GET 'http://iot.robofun.ro/api/v1/senzor/[aici_introduceti_tokenul_senzorului]/input?value=3.4'
			

Folosind python2:

				import urllib2  

print("Start Robofun Iot client.")

# Put  sensor's token - http://iot.robofun.ro
SENSOR_TOKEN="[aici_introduceti_tokenul_senzorului]"

response = urllib2.urlopen("http://iot.robofun.ro/api/v1/senzor/"+SENSOR_TOKEN+"/input?value=3.77").read()

print(response)
				
			

Exemplu complet pe github

Raspunsul serverului

Raspunsul trimis de server la apelul HTTP GET este in format text. Primul caracter este 0 sau 1. Al doilea caracter este caracterul ";". Daca serverul raspunde cu 1 apelul HTTP GET a reusit(valoarea senzorului a fost salvata pe server). Codul HTTP returnat este 200. Daca primul caracter este 0 atunci cererea a esuat. Mesajul de eroare incepe la al treilea caracter. Daca nu este gasit senzorul ( tokenul nu este corect) codul HTTP este 404 iar daca valoare senzorul este invalida codul HTTP este 400.

Exemple:

Apel cu succes:

				1;
			

Token invalid:

				0;Invalid token
			

Valoare senzor invalida:

				0;Invalid number
			

Output

Pentru exportarea datelor aveti nevoie de token-ul asociat senzorului. Obtineti adresa web pentru exportul datelor folosind token-ul, ca mai jos:

				http://iot.robofun.ro/api/v1/senzor/[aici_introduceti_tokenul_senzorului]/data.json
			

In acest moment datele pot fi exportate in format JSON. Datele calendaristice din fisierul exportat sunt in UTC in format-ul ISO 9601.

Cum folosesti Robofun IOT cu diverse placi

Exemple de proiecte folosind Robofun IOT

Daca ai nevoie de ajutor, pune o postare pe forum si promitem un raspuns foarte rapid - www.robofun.ro/forum