English

get_private_file_url

get_private_file_url只读群文件

获取私聊文件下载链接

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

Parameters

Param	Type	Required	Default
`user_id`	uint	–
`file_id`	string	✓
`file_hash`	string	–	`""`

Returns (data)

私聊文件下载链接。

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

Field	Type	Required	Description
`url`	string	✓	文件下载直链

Raw JSON Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "文件下载直链"
    }
  },
  "required": [
    "url"
  ]
}

Examples

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_private_file_url \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"user_id":10001,"file_id":"","file_hash":""}'

Using an AI assistant?

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

ON THIS PAGE

get_private_file_url#

Parameters#

Returns (data)#

Examples#

get_private_file_url

Parameters

Returns (data)

Examples