API 文档
面向已审核 Device Tree 文件的公开只读 JSON API。可用于将目录集成到机器人、应用或网站。
基础 URL
https://dtbvault.com认证
读取端点无需密钥即可使用（按 IP 限流）。如需更高限额或用于机器人，请申请个人密钥，并在每个请求的 x-api-key 头（或 Authorization: Bearer）中发送。已批准的密钥还可绕过按 IP 的访客下载上限。
申请 API 密钥端点
GET/api/files
已审核文件的分页列表。
GET/api/files/{slug}
通过公开 slug 获取单个已审核文件。
GET/api/downloads/{slug}
下载文件二进制内容。使用有效密钥时将忽略按 IP 的访客下载上限。
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
| q | string | Full-text search (filename, console, etc.) |
| console | string | Filter by console name (e.g. R36S) |
| soc | string | Filter by SoC (e.g. RK3326) |
| type | dtb | dtbo | dts | Filter by file type |
| sort | recent | popular | name | Sort order (default: recent) |
| page | number | Page number (default: 1) |
| pageSize | number | Items per page (default: 50) |
响应
每个文件返回如下：
{
"data": [
{
"slug": "rk3326-r35s-linux-2N2QPEt6",
"filename": "rk3326-r35s-linux.dtb",
"type": "dtb",
"console": "R36S",
"soc": "RK3326",
"boardRevision": "Y3506_V03_20241210 2509",
"sizeBytes": 89856,
"totalDownloads": 5,
"uploadedAt": "2026-06-21T10:00:00.000Z",
"url": "https://dtbvault.com/en/file/rk3326-r35s-linux-2N2QPEt6",
"downloadUrl": "https://dtbvault.com/api/downloads/rk3326-r35s-linux-2N2QPEt6"
}
],
"pagination": { "page": 1, "pageSize": 50, "total": 1, "totalPages": 1 }
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| slug | string | Public identifier used in URLs |
| filename | string | Original file name |
| type | string | dtb, dtbo or dts |
| console | string | Console name |
| soc | string | null | System on chip |
| boardRevision | string | null | Board revision |
| sizeBytes | number | File size in bytes |
| totalDownloads | number | Total downloads |
| uploadedAt | string (ISO) | Upload timestamp |
| url | string | Web page for the file |
| downloadUrl | string | Direct download endpoint |
限额与错误
无密钥：每个 IP 每分钟 60 次请求。使用已批准的密钥：由管理员设置的每分钟限额和每日配额。每个响应都包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset。
- 401 Unauthorized：密钥未知、待审核、被拒绝或已吊销。
- 429 且错误为 rateLimited：本分钟请求过多（参见 Retry-After）。
- 429 且错误为 quotaExceeded：已达到每日配额。
示例
# List files
curl "https://dtbvault.com/api/files?console=R36S&sort=popular&pageSize=10"
# A single file
curl "https://dtbvault.com/api/files/rk3326-r35s-linux-2N2QPEt6"
# With an API key (higher limits, no guest download cap)
curl -H "x-api-key: YOUR_KEY" "https://dtbvault.com/api/files"
# Download the binary
curl -H "x-api-key: YOUR_KEY" \
"https://dtbvault.com/api/downloads/rk3326-r35s-linux-2N2QPEt6" -o file.dtb如何获取密钥
- 在你的账户中打开 API 访问页面，提交申请并说明密钥的使用场景。
- 管理员审核申请，批准后设置你的每分钟限额和每日配额。
- 在同一页面复制你的密钥，并在 x-api-key 头中发送。