{"type":"api","title":"Register a DataApp","meta":{"id":"/apps/pubhub/media/spaces-connect-for-iot-services/8293790500ad8451a978dbb45a557b569302cec6/fe185569-32c7-3a71-a7db-7b18e6f0f371","info":{"version":"1.1.0","title":"IoT Nova NIPC APIs"},"x-parser-conf":{"overview":{"markdownPath":"reference/overview-control.md"}},"openapi":"3.0.0"},"spec":{"summary":"Register a DataApp","operationId":"registerDataApp","tags":["Registration APIs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dataApps":{"type":"array","description":"Represents the data receiver applications registered to consume streaming data from Sensor Connect.","items":{"type":"object","properties":{"dataAppID":{"type":"string","example":"telemetry-app-1"}},"required":["dataAppID"]}},"topic":{"type":"string","description":"The MQTT topic used for streaming data related to the BLE device or application.","example":"enterprise/hospital/pulse_oximeter","$$ref":"#/components/schemas/TopicString"},"dataFormat":{"type":"string","description":"Defines the data format and the supported value is “default” indicating the use of a standard or predefined data format.","example":"default","$$ref":"#/components/schemas/DataFormatString"},"controlApp":{"type":"string","description":"Represents the control application instance that manages the BLE device interactions through Sensor Connect. This value is specified during device onboarding using the SCIM API to indicate the application authorized to perform control operations on the device.","example":"controlApplication","$$ref":"#/components/schemas/ControlAppProperty"}},"required":["dataApps","topic","dataFormat","controlApp"],"$$ref":"#/components/schemas/TopicDataFormat","description":"Registers a data receiver application to consume streaming data from the IoT Orchestrator."}}}},"parameters":[{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"},"example":"8506a7e0c4242b9091bde6735dedb41f"}],"responses":{"200":{"description":"DataApp registration successful","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"SUCCESS"},"topic":{"type":"string","description":"The MQTT topic used for streaming data related to the BLE device or application.","example":"enterprise/hospital/pulse_oximeter","$$ref":"#/components/schemas/TopicString"}},"$$ref":"#/components/schemas/TopicStatusResponse"}}}}},"__originalOperationId":"registerDataApp","method":"post","path":"/control/registration/registerDataApp"}}