Retrieves the payload of the command for a deferred execution on the thing.
This API will return the string-encoded payload of the command.
If the command-definition contains the USER_AUTHORIZATION_IDS parameter (used for white-listing) one string-encoded payload is generated for each authorization id.
The string-encoded payload contains the following properties:
- ts:The timestamp UTC (in seconds) referred to the payload creation time.
- sta: The timestamp UTC (in seconds) referred to the payload validity start time.
- stp: The timestamp UTC (in seconds) referred to the payload validity stop time.
- aid: The user to thing authorization identifier.
- pid: A random identifier generated on each request.
- cmd: The name of the command.
- dat: The object holding all the command parameters.
- page: The multiple payload splitting information (present in case the USER_AUTHORIZATION_IDS is used) in the format 0xXXYY, where:
- XX is the exadecimal number identifying the total number of authorization ids.
- YY is the exadecimal number identifying the authorization index.
In case the command-definition is secure, the payload is encrypted with the Shared Key (AES certificate) configured on the Thing, and then Base64 encoded.
Required permissions: READ_THING, EXECUTE_THING_COMMAND.
The name of the target tenant (e.g. acme).
Condition on thing id.
The command name whose payload must be retrieved.
Successful operation.
The array of string-encoded payloads.
User not authenticated.
The error response.
User not authorized.
The error response.
Resource was not found.
The error response.
API call rate limit exeeded.
The error response.
Internal server error.
The error response.