Remove Channel Whitelist

​

Overview

​

Request Body

​

Required Parameters

curl -X POST "http://localhost:5001/channel/whitelist_remove" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "uids": ["user1", "user2"]
  }'

const response = await fetch('http://localhost:5001/channel/whitelist_remove', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    channel_id: 'group123',
    channel_type: 2,
    uids: ['user1', 'user2']
  })
});

const data = await response.json();
console.log(data);

import requests

data = {
    "channel_id": "group123",
    "channel_type": 2,
    "uids": ["user1", "user2"]
}

response = requests.post('http://localhost:5001/channel/whitelist_remove', json=data)
result = response.json()
print(result)

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    data := map[string]interface{}{
        "channel_id":   "group123",
        "channel_type": 2,
        "uids":         []string{"user1", "user2"},
    }
    
    jsonData, _ := json.Marshal(data)
    
    resp, err := http.Post(
        "http://localhost:5001/channel/whitelist_remove",
        "application/json",
        bytes.NewBuffer(jsonData),
    )
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Printf("%+v\n", result)
}

{
  "status": "ok"
}

​

Response Fields

​

Status Codes

​

Functionality

​

Remove Operation

1. Verify Users: Check if specified users are in the whitelist
2. Remove Entries: Delete specified users from channel whitelist
3. Permission Changes: Users lose whitelist privileges
4. Take Effect Immediately: Permission changes take effect immediately

​

Permission Impact

​

Whitelist Mode Impact

​

When Whitelist Mode is Enabled

• Removed Users: Cannot send messages to the channel
• Other Whitelisted Users: Unaffected, continue to enjoy privileges
• Regular Users: Still cannot send messages

​

When Whitelist Mode is Disabled

• Removed Users: Can still send messages normally
• Permission Changes: Mainly affects special permissions and priority

​

Use Cases

​

Permission Downgrade

# Remove users who no longer need privileges
curl -X POST "/channel/whitelist_remove" -d '{
  "channel_id": "group123",
  "channel_type": 2,
  "uids": ["former_admin"]
}'

​

Batch Cleanup

# Batch remove multiple users
curl -X POST "/channel/whitelist_remove" -d '{
  "channel_id": "group123",
  "channel_type": 2,
  "uids": ["user1", "user2", "user3"]
}'

​

Temporary Restriction

# Temporarily remove user privileges
curl -X POST "/channel/whitelist_remove" -d '{
  "channel_id": "group123",
  "channel_type": 2,
  "uids": ["temp_restricted_user"]
}'

​

Whitelist Management Strategy

​

Operation Comparison

​

Management Principles

1. Principle of Least Privilege: Only give necessary users whitelist permissions
2. Regular Review: Regularly check the necessity of whitelist users
3. Permission Grading: Assign different levels of permissions based on user roles
4. Transparent Management: Record all permission change operations

​

Best Practices

1. Permission Audit: Regularly review whitelist user activity and necessity
2. Progressive Removal: For important users, consider progressive permission downgrade
3. Notification Mechanism: Notify relevant users and administrators before removal
4. Backup Strategy: Backup current whitelist state before batch operations
5. Monitor Impact: Monitor channel activity changes after removal
6. Document Records: Record removal reasons and expected impact

​

Error Handling

​

Common Errors

​

Related APIs

• Add Channel Whitelist - Add users to whitelist
• Set Channel Whitelist - Set complete whitelist
• Get Channel Whitelist - Get current whitelist
• Remove Channel Blacklist - Remove blacklist users