ITU-T Recommendation database

Search by number:

Others:

Study Groups tree view

ITU-T Y.4473 (08/2020)

SensorThings API – Sensing

Recommendation ITU-T Y.4473 specifies the SensorThings application programming interface (API) which provides an open standard-based and geospatial-enabled framework to interconnect Internet of things (IoT) devices, data and applications over the Web.
The SensorThings API is an open standard, and that means it is non-proprietary, platform-independent. It builds on a rich set of proven-working and widely-adopted open standards, such as the web protocols and the Open Geospatial Consortium (OGC) sensor web enablement (SWE) standards, including the ISO/OGC observation and measurement data model. The SensorThings API is extensible and can be applied to not only simple but also complex use cases.
This Recommendation provides a standard way to manage and retrieve observations and metadata from heterogeneous IoT sensor systems. The SensorThings API uses representational state transfer (REST) principles, an efficient JavaScript object notation (JSON) encoding, message queuing telemetry transport (MQTT) protocol, flexible OASIS open data protocol (OData) and uniform resource locator (URL) conventions.

Citation:	https://handle.itu.int/11.1002/1000/14375
Series title:	Y series: Global information infrastructure, Internet protocol aspects, next-generation networks, Internet of Things and smart cities Y.4000-Y.4999: Internet of things and smart cities and communities Y.4400-Y.4549: Frameworks, architectures and protocols
Approval date:	2020-08-29
Provisional name:	Y.DPM-ST-API
Approval process:	AAP
Status:	In force
Maintenance responsibility:	ITU-T Study Group 20
Further details:	Patent statement(s) Development history

Ed.	ITU-T Recommendation	Status	Summary	Table of Contents	Download
1	Y.4473 (08/2020)	In force	here	here	here


ITU-T Supplement	Title	Status	Summary	Table of contents	Download
Y Suppl. 27 (01/2016)	ITU-T Y.4400 series – Smart sustainable cities - Setting the framework for an ICT architecture	In force	here	here	here
Y Suppl. 32 (07/2020)	ITU-T Y.4000 series – Smart sustainable cities - A guide for city leaders	In force	here	here	here
Y Suppl. 33 (07/2020)	ITU-T Y.4000 series – Smart sustainable cities - Master plan	In force	here	here	here
Y Suppl. 34 (07/2020)	ITU-T Y.4000 series – Smart sustainable cities - Setting the stage for stakeholders' engagement	In force	here	here	here
Y Suppl. 45 (09/2017)	ITU-T Y.4000-series - An overview of smart cities and communities and the role of information and communication technologies	In force	here	here	here
Y Suppl. 52 (12/2018)	Methodology for building digital capabilities during enterprises' digital transformation	In force	here	here	here
Y Suppl. 53 (12/2018)	ITU-T Y.4000-series – Internet of Things use cases	In force	here	here	here
Y Suppl. 54 (04/2019)	ITU-T Y.4000 series – Framework for home environment profiles and levels of IoT systems	In force	here	here	here
Y Suppl. 56 (12/2019)	ITU-T Y-series – Supplement on use cases of smart cities and communities	In force	here	here	here
Y Suppl. 58 (05/2021)	Internet of things and smart cities and communities standards roadmap	In force	here	here	here
Y Suppl. 61 (07/2020)	Features of application programming interfaces for Internet of things data in smart cities and communities	In force	here	here	here
Y Suppl. 62 (07/2020)	Overview of blockchain for supporting Internet of things and smart cities and communities in data processing and management aspects	In force	here	here	here
Y Suppl. 63 (07/2020)	Unlocking Internet of things with artificial intelligence	In force	here	here	here
Y Suppl. 68 (05/2021)	Framework for Internet of things ecosystem master plan	In force	here	here	here
Y Suppl. 69 (05/2021)	Web-based data model for Internet of things and smart city systems and services	In force	here	here	here
Y Suppl. 76 (09/2023)	ITU-T Y.4000-series – Use cases of Internet of things-based smart agriculture	In force	here	here	here

Y.4473 (2020-08)

Click here to download all the modules of this Recommendation (zipped archive)

Click here to download all the modules needed to compile this Recommendation (zipped archive)

Language	Title	OID	Obs.	Last update
JSON	Example 1 - Thing entity	-		2020-09-25
JSON	Example 10 - SensorThings request with no resource path	-		2020-09-25
JSON	Example 11 - Address an entity set	-		2020-09-25
JSON	Example 13 - Address to a property of an entity	-		2020-09-25
JSON	Example 16 - An example of addressing to an association link	-		2020-09-25
JSON	Example 18 - $expand query option	-		2020-09-25
JSON	Example 2 - Location entity	-		2020-09-25
JSON	Example 23 - $count query option	-		2020-09-25
JSON	Example 26	-		2020-09-25
JSON	Example 27	-		2020-09-25
JSON	Example 28	-		2020-09-25
JSON	Example 29 - Update the Thing whose id is 1	-		2020-09-25
JSON	Example 3 - HistoricalLocations entity	-		2020-09-25
JSON	Example 32 - MultiDatastream entity	-		2020-09-25
JSON	Example 33 - ObservedProperties collection of the MultiDatastream	-		2020-09-25
JSON	Example 34 - Observation of the MultiDatastream	-		2020-09-25
JSON	Example 35 - Getting Observation entities from a Datastream in dataArray result format	-		2020-09-25
JSON	Example 36 - Getting Observation entities from a MultiDatastream in dataArray result format	-		2020-09-25
JSON	Example 37 - Request for creating Observation entities in dataArray	-		2020-09-25
JSON	Example 38 - Response of creating Observation entities with dataArray	-		2020-09-25
JSON	Example 39 - Response of receiving updates of an entity's property with MQTT Subscribe	-		2020-09-25
JSON	Example 4 - Datastream entity	-		2020-09-25
JSON	Example 40 - An example response of receiving updates of the selected property of an entity set with MQTT Subscribe	-		2020-09-25
JSON	Example 5 - Sensor entity	-		2020-09-25
JSON	Example 6 - ObservedProperty entity	-		2020-09-25
JSON	Example 7 - Observation entity	-		2020-09-25
JSON	Example 8 - FeatureOfInterest entity	-		2020-09-25

Title	Approved on	Download
Multiple radio access technologies	2012	here

Committed to connecting the world

ITU-T Recommendations

ITU-T Y.4473 (08/2020)