# 文件列表

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

## GET /v1/files

> List files

List the account's uploaded files, newest first.

### Authentication

`Authorization: Bearer tr-xxx`

### Query Parameters

- **limit** `integer`  
  Max rows (1–100, default 20)

### Response

- **object** `string`  
  
- **data** `object[]`  
  
- **data[].id** `string`  
  File ID (with `file-` prefix)
- **data[].object** `string`  
  
- **data[].bytes** `integer`  
  Actual byte count (derived from the TOS HEAD)
- **data[].created_at** `integer`  
  Upload time (Unix seconds)
- **data[].filename** `string`  
  Original filename sent by the client
- **data[].purpose** `string`  
  Optional business-purpose label echoed back
- **data[].mime_type** `string`  
  MIME type
- **data[].type** ``image` | `video` | `audio` | `file``  
  Auto-classified file kind
- **data[].url** `string`  
  1-hour signed HTTPS read URL
- **data[].expires_at** `integer`  
  Storage expiry (Unix seconds); non-null for over-quota uploads

### Error Codes

- `401`: