get_online_clients

get_online_clients只读扩展
获取在线客户端(占位,OneBot v11 形状)

Call via POST http://127.0.0.1:3000/get_online_clients (JSON params as the body) or WebSocket.

Parameters

This action takes no parameters.

Returns (data)

{ clients }:在线设备列表(占位,clients 恒为空数组)。

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

Field Type Required Description
clients any[] 在线设备列表(占位,恒空)
Raw JSON Schema
{
  "type": "object",
  "properties": {
    "clients": {
      "type": "array",
      "description": "在线设备列表(占位,恒空)"
    }
  },
  "required": [
    "clients"
  ]
}

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_online_clients \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.