API references

As depicted in the architectural sketch, there area various interfaces, where your business solution or device integration layer can communicate with the Asset Communication package.

images/confluence/download/attachments/1581292036/architecture-bosch-iot-suite-for-asset-communication.png

Building block	API	Further notes and examples
Suite account and subscriptions management	Bosch IoT Suite - Account Management API (BETA)	Allows to programmatically manage the following type of entities: Product (i.e. what is in the service offering) Subscription (manage your subscriptions) Service Instance (a package subscription my contain multiple service instances) The easiest way is to use the user interface See https://accounts.bosch-iot-suite.com/subscriptions/
Suite Auth	Create a client and issue a token (JWT)	Allows to create an OAuth 2 client and client and to issue a token (JWT) The easiest way is to use the user interface Auth for subscription management Create a Suite Auth client
Device Provisioning	Bosch IoT Suite - Device Provisioning	Allows to programmatically register and unregister following type of entities: things and their policy devices and their credentials In fact it is a wrapper around Bosch IoT Things and Bosch IoT Hub API. Examples: Device provisioning examples
Bosch IoT Things	Bosch IoT Things HTTP API docs	Allows to programmatically manage the following type of entities: Things - digital twin of a physical device Features - functionality Policies - allows access to things and their substructures Things-Search Messages Solutions - managing you service subscription incl. namespace, connections etc.
	Ditto clients	Ditto protocol - https://www.eclipse.org/ditto/protocol-overview.html Ditto Java and JavaScript client - https://www.eclipse.org/ditto/client-sdk-java.html Ditto Go client - https://github.com/eclipse/ditto-clients-golang
	Connections/integrations	Solutions - managing you service subscription incl. namespace, connections etc. The easiest way is to use the user interface Device connectivity examples
Bosch IoT Hub	Bosch IoT Hub - Management API	Allows to programmatically manage the following type of entities: devices credentials (for devices and gateways) tenants
	Bosch IoT Hub - HTTP Adapter	Allows to programmatically send following type of messages telemetry event command control
	Hono API and clients	https://www.eclipse.org/hono/docs/api/ https://www.eclipse.org/hono/downloads/
	MQTT adapter	Examples https://docs.bosch-iot-suite.com/device-management/Examples-where-device-communicates-via-MQTT.html
	AMQP /CoAP/LoRA adapter	https://docs.bosch-iot-suite.com/device-management/Protocol-adapters.html
Bosch IoT Edge	Edge Service runtime	https://docs.bosch-iot-suite.com/edge/edge-services/#/home/edge-services-apis/en/default