📘 Vue d'ensemble

L'API Rediafile vous permet d'intégrer de manière sécurisée l'upload, la gestion et le téléchargement de fichiers directement depuis vos propres applications. Tous les endpoints retournent des réponses au format JSON encodé en UTF-8.

Base URL

Exigences techniques

🚀 Démarrage rapide

En 3 étapes, effectuez votre premier appel API :

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

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

🔐 Authentification

Toutes les requêtes API nécessitent un access_token et un account_id valides. Ceux-ci sont obtenus via l'endpoint /authorize en soumettant vos identifiants de compte ou vos clés API.

POST /authorize

Fournit un access_token et un account_id pour effectuer des requêtes ultérieures.

Paramètres

* Soit username/password, soit key1/key2. Les clés API sont recommandées pour les intégrations automatisées.

Réponse succès

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

Erreurs possibles

POST /disable_access_token

Désactive un access_token actif. Optionnel — les tokens expirent automatiquement après 1h d'inactivité.

⚠️ Codes d'erreur HTTP

Les erreurs sont retournées via les codes HTTP standards. Les informations complémentaires sont incluses dans le corps de la réponse au format JSON.

Format d'erreur JSON

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

👤 Compte

POST /account/info

Fournit les détails du compte associé à l'account_id.

Réponse

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

Fournit les restrictions du compte héritées du forfait associé.

Champs clés de la réponse

📁 Fichiers

POST /file/upload

Interface d'upload de fichiers. Note : Les uploads chunkés ne sont pas encore supportés.

Réponse succès

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

Génère une URL de téléchargement unique pour un fichier.

* Un des deux paramètres est requis : file_id OU short_url.

Réponse

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

Importe un fichier depuis une URL externe. Disponible uniquement si le téléchargement d'URL en arrière-plan est activé.

Réponse

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

Affiche le statut d'un téléchargement d'URL programmé.

Réponse (statut "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

Fournit les métadonnées et URLs d'un fichier.

POST /file/edit

Modifie les métadonnées d'un fichier.

POST /file/delete

Supprime un fichier actif (déplace vers la corbeille).

POST /file/move

Déplace un fichier vers un autre dossier.

POST /file/copy

Copie un fichier vers un autre dossier.

Réponse

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

📂 Dossiers

POST /folder/create

Crée un nouveau dossier.

POST /folder/listing

Retourne la liste des dossiers et fichiers d'un dossier parent.

Réponse

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

Fournit les informations d'un dossier spécifique.

POST /folder/edit

Modifie un dossier existant.

POST /folder/delete

Supprime un dossier.

POST /folder/move

Déplace un dossier vers un autre emplacement.

💻 Exemples de code

cURL — Authentification

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

cURL — Upload de fichier

curl -X POST https://rediafile.com/cloud/api/v2/file/upload \
  -F "access_token=VOTRE_TOKEN" \
  -F "account_id=VOTRE_ACCOUNT_ID" \
  -F "upload_file=@/chemin/vers/monfichier.zip" \
  -F "folder_id=123"

PHP — Upload complet

<?php
$token = 'VOTRE_ACCESS_TOKEN';
$accountId = 'VOTRE_ACCOUNT_ID';
$filePath = '/chemin/vers/fichier.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 — Téléchargement depuis URL

import requests, base64

url = "https://rediafile.com/cloud/api/v2/file/url_upload_add"
payload = {
    "access_token": "VOTRE_TOKEN",
    "account_id": "VOTRE_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) — Liste des dossiers

const axios = require('axios');

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

listFolders();

JavaScript (Fetch) — Générer lien de téléchargement

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

✅ Bonnes pratiques

📊 Limites & Restrictions

❓ FAQ