1. API Description
api request domain name:
iot.cloud.tencent.com/api/exploreropen/tokenapi.
This interface (AppPublishFirmwareUpdateMessage) is used for the cloud to initiate a firmware upgrade request to the device after the user confirms the upgrade.2. Input Parameter
Name | Type | Required | Description |
AccessToken | String | Yes | Common parameter. AccessToken is used for user authentication of a logged-in user. |
RequestId | String | Yes | Common parameter. Unique request ID can be generated manually. It is recommended to use uuId. When locating issues, provide the RequestId for the request. |
Action | String | Yes | Common parameter. This interface takes values: AppPublishFirmwareUpdateMessage. |
ProductId | String | Yes | Product ID. |
DeviceName | String | Yes | Device name. |
3. Output Parameters
Name | Type | Description |
RequestId | String | Common parameter. Unique request ID is the same as the input parameter. When locating issues, provide the RequestId for the request. |
4. Example
Example 1
Input Example
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1content-type: application/json{"RequestId": "584406e9-bf59-46a3-8d45-39f1891bed7b","Action": "AppPublishFirmwareUpdateMessage","ProductId": "PR******ID","DeviceName": "de***01","AccessToken": "871d2d42****************692afae0"}
Output Example: Succeed
{"Response": {"RequestId": "584406e9-bf59-46a3-8d45-39f1891bed7b"}}
5. Error Code
Error Code | Description |
InternalError | Internal error. |
InvalidParameterValue | Invalid parameter value. |
InvalidParameterValue.InvalidAccessToken | The Token is invalid. |
InvalidParameterValue.NoPermission | The user has no permission to access the device. |
ResourceNotFound | The resource does not exist. |
ResourceNotFound.DeviceHasNoFirmware | The device has no firmware version. |
FailedOperation | Operation failed. |
FailedOperation.DeviceOffline | The device is offline. |