通过 POST http://127.0.0.1:3000/get_private_file_url(请求体为 JSON 参数)或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
user_id |
uint | – | ||
file_id |
string | ✓ | ||
file_hash |
string | – | "" |
私聊文件下载链接。
所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | ✓ | 文件下载直链 |
支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入。