Rediafile Cloud API — Complete Developer Guide

Table of Contents

Overview

The Rediafile Cloud API v2 is a REST interface that lets developers integrate file storage, sharing, and folder management directly into their applications. It supports uploads up to 10 GB, temporary sharing links, and secure token-based authentication.

This guide covers every endpoint with cURL, PHP, Python, and JavaScript examples, plus production guidance for error handling, rate limits, and security.

Quick Start

1. Get a token — call /authorize with your credentials or API keys.
2. Include the token — add Authorization: Bearer <token> to every request.
3. Make calls — upload, download, and manage your files and folders.

Authentication

Authorize

POST https://rediafile.com/cloud/api/v2/authorize

Obtain a Bearer access token using account credentials or API keys.

curl -X POST https://rediafile.com/cloud/api/v2/authorize \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=admin" \
  -d "password=secret123"

Disabling Access Tokens

Disable Access Token

POST https://rediafile.com/cloud/api/v2/disable_access_token

Revoke and invalidate a previously issued access token.

curl -X POST https://rediafile.com/cloud/api/v2/disable_access_token \
  -H "Authorization: Bearer $TOKEN" \
  -d "access_token=eyJhbGciOi..."

HTTP Error Codes

Account Endpoints

Account Info

GET https://rediafile.com/cloud/api/v2/account/info

Retrieve detailed information about the authenticated account.

curl https://rediafile.com/cloud/api/v2/account/info \
  -H "Authorization: Bearer $TOKEN"

Account Package

GET https://rediafile.com/cloud/api/v2/account/package

Retrieve the current subscription package and quota details.

curl https://rediafile.com/cloud/api/v2/account/package \
  -H "Authorization: Bearer $TOKEN"

File Upload

Upload File

POST https://rediafile.com/cloud/api/v2/file/upload

Upload a file (up to 10 GB) via multipart/form-data. Returns a short URL.

curl -X POST https://rediafile.com/cloud/api/v2/file/upload \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@document.pdf"

Remote URL Upload

Remote URL Upload

POST https://rediafile.com/cloud/api/v2/file/url_upload_add

Queue a file for upload from a remote URL (server-to-server fetch).

curl -X POST https://rediafile.com/cloud/api/v2/file/url_upload_add \
  -H "Authorization: Bearer $TOKEN" \
  -d "url=https://example.com/large-file.zip"

URL Upload Status

GET https://rediafile.com/cloud/api/v2/file/url_upload_status

Check the progress of a queued remote URL upload task.

curl "https://rediafile.com/cloud/api/v2/file/url_upload_status?task_id=task_4821" \
  -H "Authorization: Bearer $TOKEN"

File Management

Download File

GET https://rediafile.com/cloud/api/v2/file/download

Get a signed temporary download URL for a file via its short URL.

curl "https://rediafile.com/cloud/api/v2/file/download?short_url=2Vv" \
  -H "Authorization: Bearer $TOKEN"

File Info

GET https://rediafile.com/cloud/api/v2/file/info

Retrieve metadata for a specific file.

curl "https://rediafile.com/cloud/api/v2/file/info?file_id=file_84729" \
  -H "Authorization: Bearer $TOKEN"

Edit File

POST https://rediafile.com/cloud/api/v2/file/edit

Update file metadata (name, password, expiry).

curl -X POST https://rediafile.com/cloud/api/v2/file/edit \
  -H "Authorization: Bearer $TOKEN" \
  -d "file_id=file_84729" \
  -d "name=renamed.pdf"

Delete File

POST https://rediafile.com/cloud/api/v2/file/delete

Permanently delete a file.

curl -X POST https://rediafile.com/cloud/api/v2/file/delete \
  -H "Authorization: Bearer $TOKEN" \
  -d "file_id=file_84729"

Move File

POST https://rediafile.com/cloud/api/v2/file/move

Move a file to a different folder.

curl -X POST https://rediafile.com/cloud/api/v2/file/move \
  -H "Authorization: Bearer $TOKEN" \
  -d "file_id=file_84729" \
  -d "folder_id=fld_123"

Copy File

POST https://rediafile.com/cloud/api/v2/file/copy

Create a copy of a file in a specified folder.

curl -X POST https://rediafile.com/cloud/api/v2/file/copy \
  -H "Authorization: Bearer $TOKEN" \
  -d "file_id=file_84729" \
  -d "folder_id=fld_456"

Folder Endpoints

Create Folder

POST https://rediafile.com/cloud/api/v2/folder/create

Create a new folder, optionally password-protected.

curl -X POST https://rediafile.com/cloud/api/v2/folder/create \
  -H "Authorization: Bearer $TOKEN" \
  -d "folder_name=My New Folder"

List Folder

GET https://rediafile.com/cloud/api/v2/folder/listing

List files and subfolders inside a folder.

curl "https://rediafile.com/cloud/api/v2/folder/listing?folder_id=fld_root" \
  -H "Authorization: Bearer $TOKEN"

Folder Management

Folder Info

GET https://rediafile.com/cloud/api/v2/folder/info

Retrieve metadata for a specific folder.

curl "https://rediafile.com/cloud/api/v2/folder/info?folder_id=fld_123" \
  -H "Authorization: Bearer $TOKEN"

Code Examples — PHP

Authorize

<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/authorize');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'username' => 'admin',
    'password' => 'secret123',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

File Upload

<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'file' => new CURLFile('/path/to/document.pdf'),
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Code Examples — Python & JavaScript

Python — Authorize

import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/authorize', data={
    'username': 'admin',
    'password': 'secret123',
})
print(resp.json())

JavaScript — File Upload

const form = new FormData();
form.append('file', fileInput.files[0]);
const res = await fetch('https://rediafile.com/cloud/api/v2/file/upload', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: form,
});

Best Practices

• Cache tokens server-side — never expose them to the browser.
• Use remote URL upload for large files hosted elsewhere.
• Handle HTTP 429 with exponential backoff.
• Regenerate temporary sharing links rather than reusing tokens.
• Watch the X-RateLimit-Remaining header to anticipate limits.

Rate Limits & File Size Limits

FAQ