avfile.io
Back to Home
Developer Docs

API Documentation

Complete reference for the avfile.io REST API. Upload, manage, and share files programmatically.

Authentication

API key management and authentication endpoints

Authorization Header

Pass your API key via the Authorization header for authenticated endpoints. Format: Authorization: Bearer avf_your_api_key_here

Authorization: Bearer avf_your_api_key_here

File Upload

Chunk-based file upload workflow

File Download & Info

Retrieve file information, download, and preview

Batch Operations

Group files into batches and perform bulk operations

User & MyPage

User info, plan details, and storage management

Folders

Organize files into folders

Utility

Configuration, analytics, QR codes, and geolocation

Rate Limits

The following limits apply to all API usage:

General Requests

No hard rate limit on general API requests. Fair use policy applies.

Upload Rate

No upload-per-hour limit on the free plan. Fair use expected.

Storage Limit

100 GB per IP address.

Max File Size

5 GB per file.

Batch Size

Maximum 50 files per batch. Maximum 100 files per batch operation.

Error Codes

The API uses standard HTTP status codes. Common errors include:

CodeStatusDescription
200OKRequest succeeded
201CreatedResource created successfully
400Bad RequestMissing or invalid parameters
401UnauthorizedMissing or invalid API key / Bearer token
403ForbiddenYou do not have permission to access this resource
404Not FoundFile, batch, or folder not found
410GoneFile has expired or been deleted
413Payload Too LargeFile size exceeds the 5GB limit
500Internal Server ErrorAn unexpected error occurred on the server
502Bad GatewayUpstream service (e.g., QR API) failed
507Insufficient StorageIP storage limit (100GB) exceeded