Cambiar idioma
ENFRES
v2

Rediafile Cloud API

Hub API para Desarrolladores y Empresas de Rediafile Cloud

URL base API: https://rediafile.com/cloud/api/v2

Inicio rápido

1

Obtén un token

Llama a /authorize con tus credenciales o claves API para obtener un Bearer token.

2

Incluye el token

Agrega Authorization: Bearer <token> a cada solicitud autenticada.

3

Realiza llamadas

Carga, descarga y gestiona tus archivos y carpetas a través de la API REST.

La autenticación usa tokens Bearer obtenidos vía /authorize. Los tokens expiran después de 24 horas. Almacénelos de forma segura y rotelos regularmente.

Autenticación

POST /authorize Probar en la caja de arena

Autorizar

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

Los tokens expiran después de 24 horas. Almacénelos de forma segura.

Parameters

NameTypeRequiredDescription
usernamestringoptional
Yes (if not using API keys)
Nombre de usuario de la cuenta admin
passwordstringoptional
Yes (if not using API keys)
Contraseña de la cuenta secret123
api_keystringoptional
Yes (if not using username/password)
Clave API pública pk_live_xxxxxxxx
api_secretstringoptional
Yes (if not using username/password)
Clave API secreta sk_live_xxxxxxxx
curl -X POST https://rediafile.com/cloud/api/v2/authorize \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=admin" \
  -d "password=secret123"
<?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);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/authorize', data={
    'username': 'admin',
    'password': 'secret123',
})
print(resp.json())
const res = await fetch('https://rediafile.com/cloud/api/v2/authorize', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({ username: 'admin', password: 'secret123' }),
});
const data = await res.json();

Sample response

{
    "status": "success",
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNTg2NDIiLCJpYXQiOjE3MjQ3MjY0MDB9.signature",
        "token_type": "Bearer",
        "expires_in": 86400,
        "account_id": "158642"
    }
}
POST /disable_access_token Probar en la caja de arena

Desactivar token de acceso

Revocar e invalidar un token de acceso emitido previamente.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
access_tokenstringrequired
Yes
El token a revocar eyJhbGciOi...
curl -X POST https://rediafile.com/cloud/api/v2/disable_access_token \
  -H "Authorization: Bearer $TOKEN" \
  -d "access_token=eyJhbGciOi..."
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/disable_access_token');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['access_token' => $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/disable_access_token',
    headers={'Authorization': f'Bearer {token}'},
    data={'access_token': token},
)
await fetch('https://rediafile.com/cloud/api/v2/disable_access_token', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ access_token: token }),
});

Sample response

{
    "status": "success",
    "data": {
        "revoked": true,
        "message": "Token has been disabled."
    }
}

Endpoints de Cuenta

GET /account/info Probar en la caja de arena

Información de la cuenta

Obtener información detallada de la cuenta autenticada.

Requiere Authorization: Bearer <token>

curl https://rediafile.com/cloud/api/v2/account/info \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/account/info');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/account/info',
    headers={'Authorization': f'Bearer {token}'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/account/info', {
  headers: { 'Authorization': `Bearer ${token}` },
});
const data = await res.json();

Sample response

{
    "status": "success",
    "data": {
        "account_id": "158642",
        "username": "admin",
        "email": "admin@example.com",
        "storage_used": "456.7 GB",
        "storage_limit": "1024 GB",
        "plan": "Business",
        "created_at": "2023-01-15T10:30:00Z"
    }
}
GET /account/package Probar en la caja de arena

Paquete de la cuenta

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

Requiere Authorization: Bearer <token>

curl https://rediafile.com/cloud/api/v2/account/package \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/account/package');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/account/package',
    headers={'Authorization': f'Bearer {token}'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/account/package', {
  headers: { 'Authorization': `Bearer ${token}` },
});
const data = await res.json();

Sample response

{
    "status": "success",
    "data": {
        "package": "Business",
        "max_file_size": "10240 MB",
        "max_storage": "1024 GB",
        "bandwidth_limit": "unlimited",
        "features": [
            "password_folders",
            "temporary_links",
            "api_access"
        ]
    }
}

Endpoints de Archivos

POST /file/upload Probar en la caja de arena

Subir archivo

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

Requiere Authorization: Bearer <token>. Use multipart/form-data.

Parameters

NameTypeRequiredDescription
filefilerequired
Yes
El archivo a subir (multipart) (binary)
folder_idstringoptional
No
ID de la carpeta de destino fld_123
curl -X POST https://rediafile.com/cloud/api/v2/file/upload \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@document.pdf"
<?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);
import requests

with open('document.pdf', 'rb') as f:
    resp = requests.post('https://rediafile.com/cloud/api/v2/file/upload',
        headers={'Authorization': f'Bearer {token}'},
        files={'file': f},
    )
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,
});

Sample response

{
    "status": "success",
    "data": [
        {
            "name": "document.pdf",
            "short_url": "2Vv",
            "url": "https://rediafile.com/2Vv",
            "size": "4.5 MB",
            "file_id": "file_84729",
            "created_at": "2024-08-26T12:00:00Z"
        }
    ]
}
GET /file/download Probar en la caja de arena

Descargar archivo

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

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
short_urlstringrequired
Yes
Código URL corta del archivo 2Vv
curl "https://rediafile.com/cloud/api/v2/file/download?short_url=2Vv" \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/download?short_url=2Vv');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/file/download',
    headers={'Authorization': f'Bearer {token}'},
    params={'short_url': '2Vv'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/file/download?short_url=2Vv', {
  headers: { 'Authorization': `Bearer ${token}` },
});
const data = await res.json();

Sample response

{
    "status": "success",
    "data": {
        "download_url": "https://rediafile.com/2Vv?download_token=abc123def456",
        "expires_at": "2024-08-26T13:00:00Z"
    }
}
POST /file/url_upload_add Probar en la caja de arena

Subida URL remota

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

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
urlstringrequired
Yes
URL remota a recuperar https://example.com/large-file.zip
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"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/url_upload_add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['url' => 'https://example.com/large-file.zip']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/file/url_upload_add',
    headers={'Authorization': f'Bearer {token}'},
    data={'url': 'https://example.com/large-file.zip'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/file/url_upload_add', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ url: 'https://example.com/large-file.zip' }),
});

Sample response

{
    "status": "success",
    "data": {
        "task_id": "task_4821",
        "status": "queued",
        "message": "URL upload added to queue."
    }
}
GET /file/url_upload_status Probar en la caja de arena

Estado subida URL

Verificar el progreso de una tarea de subida URL remota.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
task_idstringrequired
Yes
ID de tarea de url_upload_add task_4821
curl "https://rediafile.com/cloud/api/v2/file/url_upload_status?task_id=task_4821" \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/url_upload_status?task_id=task_4821');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/file/url_upload_status',
    headers={'Authorization': f'Bearer {token}'},
    params={'task_id': 'task_4821'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/file/url_upload_status?task_id=task_4821', {
  headers: { 'Authorization': `Bearer ${token}` },
});

Sample response

{
    "status": "success",
    "data": {
        "task_id": "task_4821",
        "status": "completed",
        "progress": 100,
        "file_id": "file_84730",
        "short_url": "9Xk"
    }
}
GET /file/info Probar en la caja de arena

Info de archivo

Obtener los metadatos de un archivo específico.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
file_idstringrequired
Yes
ID del archivo file_84729
curl "https://rediafile.com/cloud/api/v2/file/info?file_id=file_84729" \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/info?file_id=file_84729');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/file/info',
    headers={'Authorization': f'Bearer {token}'},
    params={'file_id': 'file_84729'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/file/info?file_id=file_84729', {
  headers: { 'Authorization': `Bearer ${token}` },
});

Sample response

{
    "status": "success",
    "data": {
        "file_id": "file_84729",
        "name": "document.pdf",
        "size": "4.5 MB",
        "type": "application/pdf",
        "short_url": "2Vv",
        "folder_id": "fld_root",
        "created_at": "2024-08-26T12:00:00Z"
    }
}
POST /file/edit Probar en la caja de arena

Editar archivo

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

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
file_idstringrequired
Yes
ID del archivo file_84729
namestringoptional
No
Nuevo nombre de archivo renamed.pdf
passwordstringoptional
No
Proteger el archivo con contraseña mypass
curl -X POST https://rediafile.com/cloud/api/v2/file/edit \
  -H "Authorization: Bearer $TOKEN" \
  -d "file_id=file_84729" \
  -d "name=renamed.pdf"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/edit');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file_id' => 'file_84729', 'name' => 'renamed.pdf']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/file/edit',
    headers={'Authorization': f'Bearer {token}'},
    data={'file_id': 'file_84729', 'name': 'renamed.pdf'},
)
await fetch('https://rediafile.com/cloud/api/v2/file/edit', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ file_id: 'file_84729', name: 'renamed.pdf' }),
});

Sample response

{
    "status": "success",
    "data": {
        "file_id": "file_84729",
        "updated": true,
        "message": "File updated."
    }
}
POST /file/delete Probar en la caja de arena

Eliminar archivo

Eliminar permanentemente un archivo.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
file_idstringrequired
Yes
ID del archivo a eliminar file_84729
curl -X POST https://rediafile.com/cloud/api/v2/file/delete \
  -H "Authorization: Bearer $TOKEN" \
  -d "file_id=file_84729"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/delete');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file_id' => 'file_84729']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/file/delete',
    headers={'Authorization': f'Bearer {token}'},
    data={'file_id': 'file_84729'},
)
await fetch('https://rediafile.com/cloud/api/v2/file/delete', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ file_id: 'file_84729' }),
});

Sample response

{
    "status": "success",
    "data": {
        "file_id": "file_84729",
        "deleted": true
    }
}
POST /file/move Probar en la caja de arena

Mover archivo

Mover un archivo a otra carpeta.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
file_idstringrequired
Yes
ID del archivo file_84729
folder_idstringrequired
Yes
ID de la carpeta de destino fld_123
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"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/move');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file_id' => 'file_84729', 'folder_id' => 'fld_123']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/file/move',
    headers={'Authorization': f'Bearer {token}'},
    data={'file_id': 'file_84729', 'folder_id': 'fld_123'},
)
await fetch('https://rediafile.com/cloud/api/v2/file/move', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ file_id: 'file_84729', folder_id: 'fld_123' }),
});

Sample response

{
    "status": "success",
    "data": {
        "file_id": "file_84729",
        "moved_to": "fld_123"
    }
}
POST /file/copy Probar en la caja de arena

Copiar archivo

Crear una copia de un archivo en una carpeta especificada.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
file_idstringrequired
Yes
ID del archivo file_84729
folder_idstringrequired
Yes
ID de la carpeta de destino fld_456
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"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/file/copy');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file_id' => 'file_84729', 'folder_id' => 'fld_456']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/file/copy',
    headers={'Authorization': f'Bearer {token}'},
    data={'file_id': 'file_84729', 'folder_id': 'fld_456'},
)
await fetch('https://rediafile.com/cloud/api/v2/file/copy', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ file_id: 'file_84729', folder_id: 'fld_456' }),
});

Sample response

{
    "status": "success",
    "data": {
        "original_id": "file_84729",
        "copy_id": "file_84730",
        "copied_to": "fld_456"
    }
}

Endpoints de Carpetas

POST /folder/create Probar en la caja de arena

Crear carpeta

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

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
folder_namestringrequired
Yes
Nombre de la nueva carpeta My New Folder
parent_idstringoptional
No
ID de la carpeta principal (para anidamiento) fld_root
passwordstringoptional
No
Contraseña para proteger la carpeta secret
curl -X POST https://rediafile.com/cloud/api/v2/folder/create \
  -H "Authorization: Bearer $TOKEN" \
  -d "folder_name=My New Folder"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/folder/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['folder_name' => 'My New Folder']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/folder/create',
    headers={'Authorization': f'Bearer {token}'},
    data={'folder_name': 'My New Folder'},
)
await fetch('https://rediafile.com/cloud/api/v2/folder/create', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ folder_name: 'My New Folder' }),
});

Sample response

{
    "status": "success",
    "data": {
        "folder_id": "fld_482",
        "folder_name": "My New Folder",
        "created_at": "2024-08-26T12:00:00Z"
    }
}
GET /folder/listing Probar en la caja de arena

Listar carpeta

Listar archivos y subcarpetas dentro de una carpeta.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
folder_idstringoptional
No (defaults to root)
ID de la carpeta (raíz si se omite) fld_root
curl "https://rediafile.com/cloud/api/v2/folder/listing?folder_id=fld_root" \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/folder/listing?folder_id=fld_root');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/folder/listing',
    headers={'Authorization': f'Bearer {token}'},
    params={'folder_id': 'fld_root'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/folder/listing?folder_id=fld_root', {
  headers: { 'Authorization': `Bearer ${token}` },
});
const data = await res.json();

Sample response

{
    "status": "success",
    "data": {
        "folder_id": "fld_root",
        "folders": [
            {
                "folder_id": "fld_123",
                "name": "Documents",
                "file_count": 12
            }
        ],
        "files": [
            {
                "file_id": "file_84729",
                "name": "document.pdf",
                "short_url": "2Vv",
                "size": "4.5 MB"
            }
        ]
    }
}
GET /folder/info Probar en la caja de arena

Info de carpeta

Obtener los metadatos de una carpeta específica.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
folder_idstringrequired
Yes
ID de la carpeta fld_123
curl "https://rediafile.com/cloud/api/v2/folder/info?folder_id=fld_123" \
  -H "Authorization: Bearer $TOKEN"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/folder/info?folder_id=fld_123');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.get('https://rediafile.com/cloud/api/v2/folder/info',
    headers={'Authorization': f'Bearer {token}'},
    params={'folder_id': 'fld_123'},
)
const res = await fetch('https://rediafile.com/cloud/api/v2/folder/info?folder_id=fld_123', {
  headers: { 'Authorization': `Bearer ${token}` },
});

Sample response

{
    "status": "success",
    "data": {
        "folder_id": "fld_123",
        "name": "Documents",
        "parent_id": "fld_root",
        "file_count": 12,
        "folder_count": 2,
        "protected": false,
        "created_at": "2024-01-10T09:00:00Z"
    }
}
POST /folder/edit Probar en la caja de arena

Editar carpeta

Actualizar los metadatos de la carpeta (nombre, contraseña).

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
folder_idstringrequired
Yes
ID de la carpeta fld_123
folder_namestringoptional
No
Nuevo nombre de la carpeta Renamed Folder
curl -X POST https://rediafile.com/cloud/api/v2/folder/edit \
  -H "Authorization: Bearer $TOKEN" \
  -d "folder_id=fld_123" \
  -d "folder_name=Renamed Folder"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/folder/edit');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['folder_id' => 'fld_123', 'folder_name' => 'Renamed Folder']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/folder/edit',
    headers={'Authorization': f'Bearer {token}'},
    data={'folder_id': 'fld_123', 'folder_name': 'Renamed Folder'},
)
await fetch('https://rediafile.com/cloud/api/v2/folder/edit', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ folder_id: 'fld_123', folder_name: 'Renamed Folder' }),
});

Sample response

{
    "status": "success",
    "data": {
        "folder_id": "fld_123",
        "updated": true
    }
}
POST /folder/delete Probar en la caja de arena

Eliminar carpeta

Eliminar permanentemente una carpeta y todo su contenido.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
folder_idstringrequired
Yes
ID de la carpeta a eliminar fld_123
curl -X POST https://rediafile.com/cloud/api/v2/folder/delete \
  -H "Authorization: Bearer $TOKEN" \
  -d "folder_id=fld_123"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/folder/delete');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['folder_id' => 'fld_123']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/folder/delete',
    headers={'Authorization': f'Bearer {token}'},
    data={'folder_id': 'fld_123'},
)
await fetch('https://rediafile.com/cloud/api/v2/folder/delete', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ folder_id: 'fld_123' }),
});

Sample response

{
    "status": "success",
    "data": {
        "folder_id": "fld_123",
        "deleted": true
    }
}
POST /folder/move Probar en la caja de arena

Mover carpeta

Mover una carpeta a otra carpeta principal.

Requiere Authorization: Bearer <token>

Parameters

NameTypeRequiredDescription
folder_idstringrequired
Yes
ID de la carpeta a mover fld_123
parent_idstringrequired
Yes
ID de la carpeta principal de destino fld_456
curl -X POST https://rediafile.com/cloud/api/v2/folder/move \
  -H "Authorization: Bearer $TOKEN" \
  -d "folder_id=fld_123" \
  -d "parent_id=fld_456"
<?php
$ch = curl_init('https://rediafile.com/cloud/api/v2/folder/move');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $token]);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['folder_id' => 'fld_123', 'parent_id' => 'fld_456']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
import requests

resp = requests.post('https://rediafile.com/cloud/api/v2/folder/move',
    headers={'Authorization': f'Bearer {token}'},
    data={'folder_id': 'fld_123', 'parent_id': 'fld_456'},
)
await fetch('https://rediafile.com/cloud/api/v2/folder/move', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}` },
  body: new URLSearchParams({ folder_id: 'fld_123', parent_id: 'fld_456' }),
});

Sample response

{
    "status": "success",
    "data": {
        "folder_id": "fld_123",
        "moved_to": "fld_456"
    }
}

HTTP Errors

200
OK
La petición tuvo éxito.
400
Bad Request
La petición estaba mal formada o faltaban parámetros requeridos.
401
Unauthorized
La autenticación falló o el token es inválido/expirado.
403
Forbidden
La cuenta no tiene permiso para este recurso.
404
Not Found
El archivo o carpeta solicitada no se encontró.
429
Too Many Requests
Límite de tasa excedido. Reintente después del retraso indicado.

Buenas prácticas

  • Almacena los tokens en el servidor — nunca los expongas al navegador.
  • 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.