Get eSource[s] / virtual devices associated with a subject
get
/api/studies/{studyId}/subjects/{subjectId}/devices
Returns virtual devices that are associated with the subject. A device here is a digital twin of a medical device or an eSource.
Request
Path Parameters
-
studyId: string
mHealth study identifier
-
subjectId: string
Subject identifer.
Query Parameters
-
esourceName(optional): string
filters the result by esource name
-
srcDeviceName(optional): string
filters the result by device name
-
surrogateSubjId(optional): string
filters the result by surrogate subject identifier
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation.
Nested Schema : device
Type:
Show Source
object
-
esourceName(optional):
string
Representation of the eSource name. Used when a device message gets into the mHealth platform through a cloud-to-cloud (c2c) connector. Leave this field empty for device-to-cloud (d2c) connector.
-
id:
string(uuid)
Device instance identifier.
-
iotDeviceId:
string(uuid)
DeviceId created for the virtual device in the underlying IoT Cloud.
-
srcDeviceName(optional):
string
An arbitrary name set by the caller application when the device instance was created.
-
studyId:
string
mHealth study identifier.
-
subjectId:
string(uuid)
Subject identifier in the mHealth Connector Cloud. Generated when a subject is registered in an mHealth study.
-
surrogateSubjId:
string
Surrogate subject identifier. This could be automatically generated by the mHealth Connector Cloud or set by the customer's subject management system. Device data payload must use this value as KEY_UID field.
-
targetSubjIdMap:
array targetSubjIdMap
Subject ID in each target application.
Nested Schema : TargetSubj
Type:
Show Source
object
-
subjId:
string
subject ID in the target application.
-
type:
string
Target type. Possible values are INFORM, DMW, or DEFAULT. Use DEFAULT type if the same subject Id is to be used across all targets. If DEFAULT and a specific target type exist in a map, the specific target type gets higher precedence over the DEFAULT type.
404 Response
Invalid study or subject identifier.