Ca va vite!

API Documentation

Note: API access is not yet available and will come soon.

Ca va vite! provides a RESTful API for automated file operations.

Authentication

All API endpoints require authentication using your access key in the Authorization header:

Authorization: Bearer your-access-key

Your access key is provided when you create an account and can be viewed in your account dashboard.

File Operations

POST /api/v1/files - Upload File

Upload a new file to your account.

curl -X POST \ -H "Authorization: Bearer your-access-key" \ -F "file=@myfile.jpg" \ -F "description=My file description" \ https://cavavite.com/api/v1/files

Response:


  "share_token": "abc123",
  "deletion_token": "xyz789",
  "filename": "myfile.jpg",
  "size": 1024,
  "mime_type": "image/jpeg",
  "share_url": "https://cavavite.com/f/abc123",
  "delete_url": "https://cavavite.com/delete/xyz789"

GET /api/v1/files/{token} - Download File

Download a file using its share token.

curl -H "Authorization: Bearer your-access-key" https://cavavite.com/api/v1/files/abc123

DELETE /api/v1/files/{token} - Delete File

Delete a file using its deletion token.

curl -X DELETE -H "Authorization: Bearer your-access-key" https://cavavite.com/api/v1/files/xyz789

Account Operations

GET /api/v1/account/status - Account Status

Get your account information and status.

curl -H "Authorization: Bearer your-access-key" \ https://cavavite.com/api/v1/account/status

Response:


  "access_key": "your-access-key",
  "tier": "free",
  "patreon_tier": "supporter",
  "storage_quota": 21474836480,
  "used_storage": 1073741824,
  "usage_percent": 5.0,
  "created_at": "2023-01-01T12:00:00Z",
  "file_count": 42

GET /api/v1/account/files - List Files

List all files in your account.

curl -H "Authorization: Bearer your-access-key" \ https://cavavite.com/api/v1/account/files

GET /api/v1/account/usage - Get Storage Usage

Get detailed storage usage statistics.

curl -H "Authorization: Bearer your-access-key" \ https://cavavite.com/api/v1/account/usage

Response:


  "total_files": 42,
  "total_size": 1073741824,
  "storage_quota": 21474836480,
  "quota_used_pct": 5.0,
  "active_files": 40,
  "deleted_files": 2