def get_device_message():
"""API endpoint to get device message.
.. :quickref: User; Download control signal from the platform
**Optional parameters**
- "duration" (6 hours by default; can be increased to plan further into the future)
**Example request**
This "GetDeviceMessageRequest" message requests targeted consumption for UDI event 203 of device 10 of owner 7.
.. code-block:: json
{
"type": "GetDeviceMessageRequest",
"event": "ea1.2018-06.io.flexmeasures.company:7:10:203:soc"
}
**Example response**
This "GetDeviceMessageResponse" message indicates that the target for UDI event 203 is to consume at various power
rates from 10am UTC onwards for a duration of 45 minutes.
.. sourcecode:: json
{
"type": "GetDeviceMessageResponse",
"event": "ea1.2018-06.io.flexmeasures.company:7:10:203:soc",
"values": [
2.15,
3,
2
],
"start": "2015-06-02T10:00:00+00:00",
"duration": "PT45M",
"unit": "MW"
}
:reqheader Authorization: The authentication token
:reqheader Content-Type: application/json
:resheader Content-Type: application/json
:status 200: PROCESSED
:status 400: INVALID_MESSAGE_TYPE, INVALID_TIMEZONE, INVALID_DOMAIN, INVALID_UNIT, UNKNOWN_SCHEDULE, UNRECOGNIZED_CONNECTION_GROUP, or UNRECOGNIZED_UDI_EVENT
:status 401: UNAUTHORIZED
:status 403: INVALID_SENDER
:status 405: INVALID_METHOD
:status 422: UNPROCESSABLE_ENTITY
"""
return v1_3_implementations.get_device_message_response()
def get_device_message():
return v1_3_implementations.get_device_message_response()