get_rkey_server

get_rkey_server只读扩展
获取 rkey 服务器信息

通过 POST http://127.0.0.1:3000/get_rkey_server(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

该动作无需参数。

返回 (data)

{ expired_time, name, private_rkey?, group_rkey? }:rkey 过期时间与(存在时的)私聊/群聊 rkey。

所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

字段 类型 必填 说明
expired_time integer 过期时间戳(秒)
name string 服务器名(恒 SnowLuma)
private_rkey string 私聊 rkey(存在时返回)
group_rkey string 群聊 rkey(存在时返回)
原始 JSON Schema
{
  "type": "object",
  "properties": {
    "expired_time": {
      "type": "integer",
      "description": "过期时间戳(秒)"
    },
    "name": {
      "type": "string",
      "description": "服务器名(恒 SnowLuma)"
    },
    "private_rkey": {
      "type": "string",
      "description": "私聊 rkey(存在时返回)"
    },
    "group_rkey": {
      "type": "string",
      "description": "群聊 rkey(存在时返回)"
    }
  },
  "required": [
    "expired_time",
    "name"
  ]
}

调用示例

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_rkey_server \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{}'
在用 AI 助手?

支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入