Call QueryToken to verify the Token.
Scenario
This method is called by the application server. QueryToken To check whether a single Token is valid. For more information, see Overview of token authentication.
Limits
The maximum number of requests per user is 100 per second. For special needs, please submit work Order application.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | QueryToken | The operation that you want to perform. Value: QueryToken |
InstanceId | String | Yes | post-cn-0pp12gl**** | The ID of the MQTT instance, which must match the client-used instance ID. In the console instance details page. |
Region ID | String | Yes | mq-internet-access | The region of the message queue for MQTT instance. |
Token | String | Yes | LzMT+XLFl5s/YWJ/MlDz4t/Lq5HC1iGU1P28HAMaxYxn8aQbALNtml7QZKl9L9kPe6LqUb95tEVo+zUqOogs9+jZwDUSzsd4X4qaD3n2TrBEuMOqKkk1Xdrvu9VBQQvIYbz7MJWZDYC3DlW7gLEr33Cuj54iIhagtBi3epStJitsssWs7otY9zhKOSZxhr49G3d0bh35mwyP18EMvDas8UlzeSozsSrujNUqZXOGK0PEBSd+rWMGDJlCt6GFmJgm2JFY7PJwf/7OOSmUYIYFs5o/PuPpoTMF+hcVXMs+0yDukIMTOzG9m3t8k36PVrghFmnK6pC3Rt3mibjW****ng== | The Token that you want to query. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 5C8AADD0-6A95-436 D-AFA0-3405CCE36A24 | The ID of the request, which is a common parameter. Each request has a unique ID. |
TokenStatus | Boolean | True | The status of the Token you have verified. Valid values:
|
Examples
Sample requests
http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/? Action=QueryToken
&InstanceId=post-cn-0pp12gl****
&RegionId=mq-internet-access
&Token=LzMT+XLFl5s/YWJ/MlDz4t/Lq5HC1iGU1P28HAMaxYxn8aQbALNtml7QZKl9L9kPe6LqUb95tEVo+zUqOogs9+jZwDUSzsd4X4qaD3n2TrBEuMOqKkk1Xdrvu9VBQQvIYbz7MJWZDYC3DlW7gLEr33Cuj54iIhagtBi3epStJitsssWs7otY9zhKOSZxhr49G3d0bh35mwyP18EMvDas8UlzeSozsSrujNUqZXOGK0PEBSd+rWMGDJlCt6GFmJgm2JFY7PJwf/7OOSmUYIYFs5o/PuPpoTMF+hcVXMs+0yDukIMTOzG9m3t8k36PVrghFmnK6pC3Rt3mibjW****ng==
&<Common request parameters>
Sample success responses
XML
format
<QueryTokenResponse>
<RequestId>5C8AADD0-6A95-436D-AFA0-3405CCE36A24</RequestId>
<TokenStatus>true</TokenStatus>
</QueryTokenResponse>
JSON
format
{
"RequestId": "5C8AADD0-6A95-436D-AFA0-3405CCE36A24",
"TokenStatus": true
}
Error codes
HTTP status code | Error | Error message | Description |
---|---|---|---|
404 | ApiNotSupport | The specified API is not supported. | The current interface is not supported. Please check. |
400 | CheckAccountInfoFailed | An error occurred while checking the account information by the STS token. | An error occurred while parsing the account information in the STS Token. |
400 | InstancePermissionCheckFailed | An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings. | The error message returned because the instance permission verification fails. Check the ownership and authorization policy of the MQTT instance. |
500 | InternalError | An error occurred while processing your request. Try again later. | The MQTT backend service is abnormal. Please try again. |
400 | ParameterCheckFailed | An error occurred while validating the parameters. The parameters may be missing or invalid. | The parameter verification fails. This parameter may be missing or invalid. |
400 | PermissionCheckFailed | An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings. | The error message returned because the resource permission verification failed. Check the instance, Topic, and Group ID for their permissions and authorization policies. |
400 | QueryTokenOverFlow | You have queried tokens too many times. Please try again later. | token query is too frequent for system throttling. Try again later. |
500 | SystemOverFlow | An error occurred while processing your request. Please try again. | System throttling. Please try again. |
400 | InvalidParameter.%s | An error occurred while validating the parameter. The parameter may be missing or invalid. | The parameter verification fails. This parameter may be missing or invalid. |
For a list of error codes, visit the API Error Center.