getFile

获取文件的下载信息。获取后可通过 /file/:token/:path/:filename 下载文件。文件大小不超过 20MB。

请求

GET /:token/getfile

POST /:token/getfile

本方法同时支持 GET 和 POST 请求。

参数

参数	类型	必填	描述
file_id	String	是	要获取信息的文件标识符

响应

返回 File 对象。

json

{
  "ok": true,
  "result": {
    "file_id": "BAADBAADAgADr4QLHFZ2Z7RXXXxxx",
    "file_unique_id": "AgADr4QLHFZ2Z7Q",
    "file_size": 1024000,
    "file_path": "documents/file_0.pdf"
  }
}

返回字段说明

字段	类型	描述
file_id	String	文件的唯一标识符
file_unique_id	String	文件的全局唯一标识符，跨 Bot 不变
file_size	Integer	文件大小（字节）
file_path	String	文件路径，可用于下载文件

错误码

错误码	描述
400	请求参数错误，如 file_id 无效
401	Token 无效或已过期
404	文件不存在
500	服务器内部错误

getFile ​

请求 ​

参数 ​

响应 ​

返回字段说明 ​

错误码 ​

getFile

请求

参数

响应

返回字段说明

错误码