pzaragoza93/iot-basic-server

This is a basic server for a IoT project for a class taught at the University of Montpellier (HMIN302: Embedded Systems)

iot-basic-server

This is a basic server for an IoT project for a class taught at the University of Montpellier (HMIN302: Embedded Systems)

How to setup

Instalation

the installation requires Maven (https://maven.apache.org)

Inside the project folder, run the terminal command

mvn package (this will package the java project into an executable jar)

cd target/ (the jar is located in the target folder of the project)

java -jar iot-server-x.x.x-SNAPSHOT.jar (select and run the proper iot-server version for your project)

the default port from the server to run in localhost is 8000. To access the server go to your web browser and go to : http://localhost:8000

OR

Clone project and Import Project in Eclipse as existing Maven Project. Once the project is loaded into Eclipse, run as Maven Build... and choose package as the goal. Finally, run the project as a JAVA Application with the main class.

Server Connection

To connect and retrieve the last 20 messages on the server GET:

localhost:8000/message-exchange/messages/

or

https://hmin309-embedded-systems.herokuapp.com/message-exchange/messages/

To send a message with data use the POST request for the same address.

API

Message API

Get Message information

get message information

Example request

GET messages

Example request

make sure to incudle the '/' at the end of your request otherwise it will return false

$ curl localhost:8000/message-exchange/messages/

or

$ curl https://hmin309-embedded-systems.herokuapp.com/message-exchange/messages/

Example response

[
{
  "id":10001,
  "student_id":20130039,
  "gps_lat":34.001,
  "gps_long":3.235,
  "student_message":"message1"
},
{"id":10002,"student_id":20130039,"gps_lat":35.001,"gps_long":3.235,"student_message":"message2"},{"id":10003,"student_id":20130039,"gps_lat":36.001,"gps_long":3.235,"student_message":"message3"}
]

Post Message information

post message information

Example request

POST messages

Example request

make sure to incudle the '/' at the end of your request otherwise it will return false

$ curl localhost:8000/message-exchange/messages/

or

$ curl https://hmin309-embedded-systems.herokuapp.com/message-exchange/messages/

Example request

(content-type: application/json)

{
  "student_id": 20130039,
  "gps_lat": 34.001,
  "gps_long": 3.235,
  "student_message": "message1"
}

Problem?

contact: zaragoza at lirmm.fr