Quickstart


Getting Started with the OGC IoT RESTful API is easy. Jump right into the API resource documentation, explore the examples in the interactive SDK, or check out the reference implementation. Have a question? Read the FAQ. Don't know what to build? Check out the Ecosystems.


Sensor Owner

You need to register your sensor on the SWE IoT server. The fastest way is to see the examples provided by the Interactive SDK.

  1. Go to the interactive SDK here.
  2. Select the Entity to "Things".
  3. Select the Action to "Full Create".
  4. Copy the request to your device code (omit the "Tasking Capabilities" attribute since it is not relevant to a sensor).
  5. After sending the request, extract the registered thing's location and thing's ID (surrounded by parentheses) from the response header (e. g., Location: http://demo.student.geocens.ca:8080/SWIOT_V0.9/Things(13)).
You can also register things, locations, datastreams, observedProberties, Sensors, Observations, and FeaturesOfInterest separately. You only need to select "Simple Create" action for the thing registration and "Full Create" action for the rest.

Actuator Owner

You need to register your actuator to the SWE IoT server. The fastest way is to see the examples provided by the Interactive SDK.

  1. Go to the interactive SDK here.
  2. Select the Entity to "Things".
  3. Select the Action to "Full Create".
  4. Copy the request to your device code (omit the "Datastreams" attribute since it is not relevant to an actuator).
  5. After sending the request, extract the registered thing's location and thing's ID (surrounded by parentheses) from the response header (e. g., Location: http://demo.student.geocens.ca:8080/SWIOT_V0.9/Things(13)).
You can also register things, taskingCapabilities, actuators, and tasks separately. You only need to select "Simple Create" action for the thing registration and "Full Create" action for the rest.

Application Developer

You want to get JSON-formatted data from the SWE IoT server. Thus, you only need to look at the SWE IoT Server here.

End User

You can simply explore the SWE IoT server containing some simulated data from here.