Rediafile Cloud API — Guía completa para desarrolladores

Tabla de contenidos

Descripción general

La API Cloud de Rediafile v2 es una interfaz REST que permite a los desarrolladores integrar almacenamiento de archivos, uso compartido y gestión de carpetas directamente en sus aplicaciones. Admite cargas de hasta 10 GB, enlaces de uso compartido temporales y autenticación segura basada en tokens.

Esta guía cubre cada endpoint con ejemplos en cURL, PHP, Python y JavaScript, además de consejos de producción para el manejo de errores, los límites de velocidad y la seguridad.

Inicio rápido

1. Obtén un token — llama a /authorize con tus credenciales o claves API.
2. Incluye el token — agrega Authorization: Bearer <token> a cada solicitud.
3. Realiza llamadas — carga, descarga, gestiona tus archivos y carpetas.

Autenticación

Autorizar

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

Obtener un token de acceso Bearer con las credenciales de la cuenta o las claves API.

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

Desactivación de tokens de acceso

Desactivar token de acceso

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

Revocar e invalidar un token de acceso emitido previamente.

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

Códigos de error HTTP

Endpoints de cuenta

Información de la cuenta

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

Obtener información detallada de la cuenta autenticada.

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

Paquete de la cuenta

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

Obtener el paquete de suscripción actual y los detalles de la cuota.

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

Carga de archivos

Subir archivo

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

Subir un archivo (hasta 10 GB) vía multipart/form-data. Devuelve una URL corta.

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

Carga desde URL remota

Subida URL remota

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

Poner en cola un archivo para subir desde una URL remota (recuperación servidor a servidor).

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"

Estado subida URL

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

Verificar el progreso de una tarea de subida URL remota.

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

Gestión de archivos

Descargar archivo

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

Obtener una URL de descarga temporal firmada vía su URL corta.

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

Info de archivo

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

Obtener los metadatos de un archivo específico.

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

Editar archivo

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

Actualizar los metadatos del archivo (nombre, contraseña, caducidad).

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

Eliminar archivo

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

Eliminar permanentemente un archivo.

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

Mover archivo

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

Mover un archivo a otra carpeta.

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"

Copiar archivo

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

Crear una copia de un archivo en una carpeta especificada.

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"

Endpoints de carpetas

Crear carpeta

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

Crear una nueva carpeta, opcionalmente protegida con contraseña.

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

Listar carpeta

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

Listar archivos y subcarpetas dentro de una carpeta.

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

Gestión de carpetas

Info de carpeta

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

Obtener los metadatos de una carpeta específica.

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

Ejemplos de código — 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);

Ejemplos de código — Python y 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,
});

Buenas prácticas

• Almacena los tokens en caché — nunca los expongas en el cliente.
• Usa la carga por URL para archivos remotos grandes.
• Maneja el código 429 con retroceso exponencial.
• Regenera los enlaces de uso compartido temporales en lugar de reutilizar tokens.
• Monitorea el encabezado X-RateLimit-Remaining para anticipar los límites.

Límites de velocidad y tamaño de archivo

Preguntas frecuentes