# 文件列表

列出当前账号已上传的文件，按创建时间倒序。

## GET /v1/files

> 文件列表

列出当前账号已上传的文件，按创建时间倒序。

### Authentication

`Authorization: Bearer tr-xxx`

### Query Parameters

- **limit** `integer`  
  返回数量（1–100，默认 20）

### Response

- **object** `string`  
  
- **data** `object[]`  
  
- **data[].id** `string`  
  文件 ID（`file-` 前缀）
- **data[].object** `string`  
  
- **data[].bytes** `integer`  
  实际字节数（以对象存储 HEAD 为准）
- **data[].created_at** `integer`  
  上传时间，Unix 秒
- **data[].filename** `string`  
  上传时的原文件名
- **data[].purpose** `string`  
  调用方传入的业务标签
- **data[].mime_type** `string`  
  MIME 类型
- **data[].type** ``image` | `video` | `audio` | `file``  
  自动归类的文件种类
- **data[].url** `string`  
  1 小时有效的 HTTPS 读取 URL
- **data[].expires_at** `integer`  
  存储到期时间（Unix 秒），超配额时非空

### Error Codes

- `401`: