Rediafile Cloud API v2

📘 Overview

The Rediafile API allows you to securely integrate file upload, management, and download directly into your own applications. All endpoints return JSON responses encoded in UTF-8.

Base URL

Technical requirements

🚀 Quick start

In 3 steps, make your first API call:

curl -X POST https://rediafile.com/cloud/api/v2/authorize \
  -d "username=your_username" \
  -d "password=your_password"

curl -X POST https://rediafile.com/cloud/api/v2/account/info \
  -d "access_token=YOUR_TOKEN" \
  -d "account_id=YOUR_ACCOUNT_ID"

🔐 Authentication

All API requests require a valid access_token and account_id. These are obtained via the /authorize endpoint by submitting your account credentials or API keys.

POST /authorize

Provides an access_token and account_id for subsequent requests.

Parameters

* Either username/password OR key1/key2. API keys are recommended for automated integrations.

Success response

{
  "data": {
    "access_token": "X3Xp6cUcue22Q3AlpCiZz3mJQWPT2v10zZqGblSGzVIqZiMoV4ou8LeYH4SKAUL9...",
    "account_id": "158642"
  },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

Possible errors

POST /disable_access_token

Deactivates an active access_token. Optional — tokens expire automatically after 1 hour of inactivity.

⚠️ HTTP error codes

Errors are returned via standard HTTP status codes. Additional details are included in the JSON response body.

JSON error format

{
  "status": "error",
  "response": "Could not authenticate user. The username and password may be invalid...",
  "_datetime": "2026-08-01 14:12:11"
}

👤 Account

POST /account/info

Provides details of the account associated with the account_id.

Response

{
  "data": {
    "id": "158642",
    "username": "admin",
    "level_id": "20",
    "email": "email@yoursite.com",
    "lastlogindate": "2017-02-18 11:43:39",
    "lastloginip": "192.168.33.1",
    "status": "active",
    "title": "Mr",
    "firstname": "Admin",
    "lastname": "User",
    "languageId": "1",
    "datecreated": null,
    "lastPayment": "2011-12-27 13:45:22",
    "paidExpiryDate": null,
    "storageLimitOverride": null
  },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

POST /account/package

Provides the account restrictions inherited from the associated plan.

Key response fields

📁 Files

POST /file/upload

File upload interface. Note: Chunked uploads are not yet supported.

Success response

{
  "response": "File uploaded",
  "data": [{
    "name": "sample4_l.jpg",
    "size": "149084",
    "type": "application/octet-stream",
    "url": "https://rediafile.com/2Vv",
    "delete_url": "https://rediafile.com/2Vv~d?41efa710444abad11a8f4b5a90e4d746",
    "info_url": "https://rediafile.com/2Vv~i",
    "stats_url": "https://rediafile.com/2Vv~s",
    "short_url": "2Vv",
    "file_id": "1253",
    "unique_hash": "60b0be7e3b18de9a3f00d940a8e5a9834c6cdc0f49d40af64973be5ca504c4fd",
    "url_html": "<a href=...>view sample4_l.jpg on Rediafile</a>",
    "url_bbcode": "[url]https://rediafile.com/2Vv[/url]"
  }],
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

POST /file/download

Generates a unique download URL for a file.

* Either file_id OR short_url is required.

Response

{
  "data": {
    "file_id": "1253",
    "filename": "sample4_l.jpg",
    "download_url": "https://rediafile.com/2Vv?download_token=c3e6289a23e9819d8663569da96087d0..."
  },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

POST /file/url_upload_add

Imports a file from an external URL. Available only if background URL download is enabled.

Response

{
  "response": "File download from URL scheduled",
  "data": {
    "scheduled_item_id": 52,
    "url": "https://yetishare.com/_include/images/yetishare_logo.png"
  },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

POST /file/url_upload_status

Displays the status of a scheduled URL download.

Response (status "complete")

{
  "response": "Scheduled URL file download found",
  "data": {
    "scheduled_item_id": 51,
    "status": "complete",
    "created": "2024-01-25 19:34:52",
    "started": "2024-01-25 20:24:53",
    "finished": "2024-01-25 20:24:54",
    "total_size": 17262,
    "downloaded_file": {
      "file_id": 11456,
      "name": "file_upload_script_logo.png",
      "size": 17262,
      "url": "https://rediafile.com/sZG/file_upload_script_logo.png"
    }
  },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

POST /file/info

Provides metadata and URLs for a file.

POST /file/edit

Modifies file metadata.

POST /file/delete

Deletes an active file (moves to trash).

POST /file/move

Moves a file to another folder.

POST /file/copy

Copies a file to another folder.

Response

{
  "response": "File successfully copyied.",
  "original_file": { "data": { "id": "1162", "filename": "...", "shortUrl": "2U2" } },
  "new_file": { "data": { "id": "1254", "filename": "...", "shortUrl": "2Vw" } },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

📂 Folders

POST /folder/create

Creates a new folder.

POST /folder/listing

Returns the list of folders and files in a parent folder.

Response

{
  "data": {
    "folders": [ { "id": "123", "folderName": "My Folder 1", ... } ],
    "files": [ { "id": "1161", "filename": "button_back.gif", "shortUrl": "2U1", ... } ]
  },
  "_status": "success",
  "_datetime": "2026-08-01 14:12:11"
}

POST /folder/info

Provides information about a specific folder.

POST /folder/edit

Modifies an existing folder.

POST /folder/delete

Deletes a folder.

POST /folder/move

Moves a folder to another location.

💻 Code examples

cURL — Authentication

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

cURL — File upload

curl -X POST https://rediafile.com/cloud/api/v2/file/upload \
  -F "access_token=YOUR_TOKEN" \
  -F "account_id=YOUR_ACCOUNT_ID" \
  -F "upload_file=@/path/to/your/file.zip" \
  -F "folder_id=123"

PHP — Complete upload

<?php
$token = 'YOUR_ACCESS_TOKEN';
$accountId = 'YOUR_ACCOUNT_ID';
$filePath = '/path/to/file.jpg';

$ch = curl_init('https://rediafile.com/cloud/api/v2/file/upload');
$postData = [
    'access_token' => $token,
    'account_id' => $accountId,
    'upload_file' => new CURLFile($filePath)
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

echo "URL: " . $data['data'][0]['url'];
curl_close($ch);
?>

Python — Download from URL

import requests, base64

url = "https://rediafile.com/cloud/api/v2/file/url_upload_add"
payload = {
    "access_token": "YOUR_TOKEN",
    "account_id": "YOUR_ACCOUNT_ID",
    "file_url_base64": base64.b64encode(b"https://example.com/image.png").decode(),
    "folder_id": "123"
}

response = requests.post(url, data=payload)
print(response.json())

JavaScript (Node.js) — List folders

const axios = require('axios');

async function listFolders() {
  const res = await axios.post('https://rediafile.com/cloud/api/v2/folder/listing', {
    access_token: 'YOUR_TOKEN',
    account_id: 'YOUR_ACCOUNT_ID',
    parent_folder_id: ''  // root
  });
  console.log(res.data.data.folders);
}

listFolders();

JavaScript (Fetch) — Generate download link

fetch('https://rediafile.com/cloud/api/v2/file/download', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    access_token: 'YOUR_TOKEN',
    account_id: 'YOUR_ACCOUNT_ID',
    file_id: '1253'
  })
})
.then(r => r.json())
.then(data => console.log(data.data.download_url));

✅ Best practices

📊 Limits & Restrictions

❓ FAQ