Overview
This API provides HTTP endpoints for listing and downloading files. Typical use cases include static asset delivery, client updates, and internal tools.
Base URL:
https://example.com/api/v1
Status: Healthy
Avg latency: < 40 ms
Endpoints
GET List files
/api/v1/files?limit=50&type=binary
Returns a paginated list of available files.
| Query | Type | Required | Description |
|---|---|---|---|
limit |
integer | false | Maximum number of files to return (default: 20, max: 100). |
type |
string | false | Optional file type filter (e.g. binary, image). |
{
"status": "ok",
"count": 3,
"files": [
{
"id": "release-2024-11-01",
"name": "client-release-2024-11-01.bin",
"size_bytes": 734003200,
"checksum": "sha256:3b8c7a...",
"download_url": "/api/v1/files/release-2024-11-01/download"
},
{
"id": "hotfix-2024-11-10",
"name": "client-hotfix-2024-11-10.bin",
"size_bytes": 52428800,
"checksum": "sha256:94aa02...",
"download_url": "/api/v1/files/hotfix-2024-11-10/download"
},
{
"id": "assets-2024-11",
"name": "static-assets-2024-11.zip",
"size_bytes": 209715200,
"checksum": "sha256:6fd0c1...",
"download_url": "/api/v1/files/assets-2024-11/download"
}
]
}
Download file
GET Download binary
/api/v1/files/{id}/download
Streams the file as an HTTP download.
| Path param | Type | Required | Description |
|---|---|---|---|
id |
string | true | Unique file identifier returned by the list endpoint. |
Response headers typically include
Content-Type: application/octet-stream and
Content-Disposition: attachment; filename="...".
# No request sent yet.
# Use the input above and click "Fake request".
Notes
This page is a static mock used for documentation, UI testing, and traffic simulation. Endpoints shown here may not exist on this environment.