Invalidate Token

Invalidate all tokens obtained by a specified user before a certain point in time.

When a user ID obtains multiple tokens (e.g., by reissuing a token), all previously obtained tokens remain valid within their expiration period. You can invalidate all tokens for a specific user based on business needs. Invalidating a token does not affect existing connections established with that token.

• Once a client user reconnects (including automatic reconnection in case of weak network), a token invalidation error will be returned. At this point, a new token should be obtained.
• After token invalidation, if an app user attempts to establish an IM connection using an invalidated token, a token invalidation error will be returned. At this point, a new token should be obtained.

Token Expiration

Tokens are permanently valid by default. The expiration period can be modified in the Console.

Request Method

POST: https://Data Center Domain/user/token/expire.json

Rate Limit: 100 requests per second

Signature Rule: All server API requests require signature verification. For details, see API Request Signature.

Body Parameters

The HTTP request body data format is application/x-www-form-urlencoded. The following HTTP form parameters are supported:

Parameter	Type	Required	Description
userId	String	Yes	The user ID for which the token should be invalidated. Supports multiple users, up to a maximum of 20.
time	Long	Yes	The expiration timestamp in milliseconds. All tokens obtained by the user before this timestamp will be invalidated. Users already connected with tokens obtained before this timestamp will not be immediately disconnected but will be unable to reconnect after disconnection.

Request Example

POST /user/token/expire.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

userId=test1&userId=test2&time=1615362955344

Response

The HTTP response body contains a JSON object with the following structure:

Return Value	Type	Description
code	Int	Return code, 200 indicates success.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}