Update User Token

Update user authentication token

POST /user/token

Try it

cURL

curl -X POST "http://localhost:5001/user/token" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "user123",
    "token": "new_auth_token_here",
    "device_flag": 1,
    "device_level": 1
  }'

Success Response

{
  "status": "ok"
}

Overview

Update user authentication token, used for user re-login or token refresh scenarios.

Request Body

Required Parameters

uid · string · required

Unique user ID for communication, can be random uuid (recommended to use your server’s unique user uid) (required by WuKongIMSDK)

token · string · required

Verification token, random uuid (recommended to use your server’s user token) (required by WuKongIMSDK)

device_flag · integer · required

Device identifier: 0=app, 1=web, 2=desktop (main devices with same user and same device flag will kick each other, secondary devices will coexist)

Optional Parameters

device_level · integer

Device level: 0=secondary device, 1=main device

cURL

curl -X POST "http://localhost:5001/user/token" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "user123",
    "token": "new_auth_token_here",
    "device_flag": 1,
    "device_level": 1
  }'

Success Response

{
  "status": "ok"
}

Response Fields

status · string · required

Operation status, returns "ok" on success

Status Codes

Status Code	Description
200	Token updated successfully
400	Request parameter error
500	Internal server error

Best Practices

1. Token Security: Ensure tokens have sufficient complexity and uniqueness
2. Device Identification: Properly set device_flag to distinguish different device types
3. Permission Control: Use device_level to implement permission control for different devices
4. Regular Refresh: Implement regular token refresh mechanism
5. Multi-device Management: Generate different tokens for different devices for easier management and revocation