📘 Vista general

La API de Rediafile te permite integrar de manera segura la subida, gestión y descarga de archivos directamente desde tus propias aplicaciones. Todos los endpoints devuelven respuestas en formato JSON codificado en UTF-8.

URL Base

Requisitos técnicos

🚀 Inicio rápido

En 3 pasos, realiza tu primera llamada API:

curl -X POST https://rediafile.com/cloud/api/v2/authorize \


  -d "username=tu_usuario" \


  -d "password=tu_contraseña"

curl -X POST https://rediafile.com/cloud/api/v2/account/info \


  -d "access_token=TU_TOKEN" \


  -d "account_id=TU_ACCOUNT_ID"

🔐 Autenticación

Todas las solicitudes API requieren un access_token y un account_id válidos. Estos se obtienen mediante el endpoint /authorize enviando tus credenciales de cuenta o tus claves API.

POST /authorize

Proporciona un access_token y un account_id para realizar solicitudes posteriores.

Parámetros

* O username/password, o key1/key2. Las claves API son recomendadas para integraciones automatizadas.

Respuesta exitosa

{


  "data": {


    "access_token": "X3Xp6cUcue22Q3AlpCiZz3mJQWPT2v10zZqGblSGzVIqZiMoV4ou8LeYH4SKAUL9...",


    "account_id": "158642"


  },


  "_status": "success",


  "_datetime": "2026-08-01 14:12:11"


}

Errores posibles

POST /disable_access_token

Desactiva un access_token activo. Opcional — los tokens expiran automáticamente después de 1 hora de inactividad.

⚠️ Códigos de error HTTP

Los errores se devuelven mediante códigos HTTP estándar. La información adicional se incluye en el cuerpo de la respuesta en formato JSON.

Formato de error JSON

{


  "status": "error",


  "response": "Could not authenticate user. The username and password may be invalid...",


  "_datetime": "2026-08-01 14:12:11"


}

👤 Cuenta

POST /account/info

Proporciona los detalles de la cuenta asociada al account_id.

Respuesta

{


  "data": {


    "id": "158642",


    "username": "admin",


    "level_id": "20",


    "email": "email@tusitio.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

Proporciona las restricciones de la cuenta heredadas del plan asociado.

Campos clave de la respuesta

📁 Archivos

POST /file/upload

Interfaz de subida de archivos. Nota: Las subidas fragmentadas (chunked) aún no son compatibles.

Respuesta exitosa

{


  "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

Genera una URL de descarga única para un archivo.

* Uno de los dos parámetros es requerido: file_id O short_url.

Respuesta

{


  "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

Importa un archivo desde una URL externa. Disponible solo si la descarga de URL en segundo plano está activada.

Respuesta

{


  "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

Muestra el estado de una descarga de URL programada.

Respuesta (estado "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

Proporciona los metadatos y URLs de un archivo.

POST /file/edit

Modifica los metadatos de un archivo.

POST /file/delete

Elimina un archivo activo (lo mueve a la papelera).

POST /file/move

Mueve un archivo a otra carpeta.

POST /file/copy

Copia un archivo a otra carpeta.

Respuesta

{


  "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"


}

📂 Carpetas

POST /folder/create

Crea una nueva carpeta.

POST /folder/listing

Devuelve la lista de carpetas y archivos de una carpeta padre.

Respuesta

{


  "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

Proporciona la información de una carpeta específica.

POST /folder/edit

Modifica una carpeta existente.

POST /folder/delete

Elimina una carpeta.

POST /folder/move

Mueve una carpeta a otra ubicación.

💻 Ejemplos de código

cURL — Autenticación

curl -X POST https://rediafile.com/cloud/api/v2/authorize \


  -H "Content-Type: application/x-www-form-urlencoded" \


  -d "username=admin" \


  -d "password=mi_contraseña"

cURL — Subida de archivo

curl -X POST https://rediafile.com/cloud/api/v2/file/upload \


  -F "access_token=TU_TOKEN" \


  -F "account_id=TU_ACCOUNT_ID" \


  -F "upload_file=@/ruta/a/miarchivo.zip" \


  -F "folder_id=123"

PHP — Subida completa

<?php


$token = 'TU_ACCESS_TOKEN';


$accountId = 'TU_ACCOUNT_ID';


$filePath = '/ruta/a/archivo.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 — Descarga desde URL

import requests, base64





url = "https://rediafile.com/cloud/api/v2/file/url_upload_add"


payload = {


    "access_token": "TU_TOKEN",


    "account_id": "TU_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) — Lista de carpetas

const axios = require('axios');





async function listFolders() {


  const res = await axios.post('https://rediafile.com/cloud/api/v2/folder/listing', {


    access_token: 'TU_TOKEN',


    account_id: 'TU_ACCOUNT_ID',


    parent_folder_id: ''  // raíz


  });


  console.log(res.data.data.folders);


}





listFolders();

JavaScript (Fetch) — Generar enlace de descarga

fetch('https://rediafile.com/cloud/api/v2/file/download', {


  method: 'POST',


  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },


  body: new URLSearchParams({


    access_token: 'TU_TOKEN',


    account_id: 'TU_ACCOUNT_ID',


    file_id: '1253'


  })


})


.then(r => r.json())


.then(data => console.log(data.data.download_url));

✅ Buenas prácticas

📊 Límites y restricciones

❓ FAQ