🔌 Documentation API REST

Comment s'authentifier ?

Chaque requête doit inclure votre clé API dans l'en-tête HTTP X-API-Key.

X-API-Key: udc_votre_cle_ici

Comment obtenir une clé API ?

1. Connectez-vous à votre tableau de bord
2. Cliquez sur Développeur dans le menu gauche
3. Cliquez sur + Générer une clé
4. Donnez un nom à votre clé (ex : "Mon Application")
5. Copiez la clé affichée — elle ne sera plus visible ensuite

⚠️ Gardez votre clé secrète. Ne la publiez jamais dans votre code source public (GitHub). Utilisez des variables d'environnement.

Plans requis

L'API est réservée aux plans payants :

Plan	Requêtes/minute	Taille max fichier	Fichiers/jour
Essentials	100	5 Go	50
Pro	300	25 Go	200
Business	1 000	1 To	1 000

Endpoints disponibles

Cliquez sur un endpoint pour voir les détails.

curl -X GET https://udcshare.com/api/v1/account \
  -H "X-API-Key: udc_votre_cle_ici"

{
  "id": "abc123",
  "email": "vous@email.com",
  "full_name": "Votre Nom",
  "plan": "pro",
  "subscription": {
    "expires_at": "2026-07-11T00:00:00Z",
    "days_remaining": 30
  },
  "api_limits": {
    "max_upload": 26843545600,
    "max_files_per_day": 200,
    "api_rate_limit": 300
  }
}

curl -X POST https://udcshare.com/api/v1/upload \
  -H "X-API-Key: udc_votre_cle_ici" \
  -F "file=@mon_document.pdf"

{
  "file_id": "xyz789",
  "filename": "mon_document.pdf",
  "filesize": 8692,
  "file_url": "https://udcshare.com/d/xyz789",
  "plan": "pro",
  "remaining_daily_uploads": 199
}

curl -X GET https://udcshare.com/api/v1/files \
  -H "X-API-Key: udc_votre_cle_ici"

{
  "files": [
    {
      "id": "xyz789",
      "filename": "mon_document.pdf",
      "filesize": 8692,
      "mime_type": "application/pdf",
      "created_at": "2026-06-11T10:00:00Z",
      "file_url": "https://udcshare.com/d/xyz789"
    }
  ],
  "total": 1
}

curl -X DELETE https://udcshare.com/api/v1/files/xyz789 \
  -H "X-API-Key: udc_votre_cle_ici"

{ "success": true, "message": "Fichier supprimé" }

curl -X GET https://udcshare.com/api/v1/stats \
  -H "X-API-Key: udc_votre_cle_ici"

{
  "total_files": 25,
  "total_storage_bytes": 5368709120,
  "total_storage_gb": 5.0,
  "account_created": "2026-01-01T00:00:00Z"
}

Limites selon votre plan

Les limites sont appliquées automatiquement. Si vous les dépassez, vous recevrez une erreur 429 Trop de requêtes.

Plan Essentials

Paramètre	Limite
Requêtes par minute	100
Taille max par fichier	5 Go
Fichiers par jour	50

Plan Pro

Paramètre	Limite
Requêtes par minute	300
Taille max par fichier	25 Go
Fichiers par jour	200

Plan Business

Paramètre	Limite
Requêtes par minute	1 000
Taille max par fichier	1 To
Fichiers par jour	1 000

Exemples de code

🐍 Python

import requests

API_KEY = "udc_votre_cle_ici"
headers = {"X-API-Key": API_KEY}

# Uploader un fichier
with open("document.pdf", "rb") as f:
    response = requests.post(
        "https://udcshare.com/api/v1/upload",
        headers=headers,
        files={"file": f}
    )
    data = response.json()
    print("Lien :", data["file_url"])

🟢 JavaScript / Node.js

const fs = require("fs");
const FormData = require("form-data");
const fetch = require("node-fetch");

const form = new FormData();
form.append("file", fs.createReadStream("document.pdf"));

const res = await fetch("https://udcshare.com/api/v1/upload", {
  method: "POST",
  headers: { "X-API-Key": "udc_votre_cle_ici", ...form.getHeaders() },
  body: form,
});
const data = await res.json();
console.log("Lien :", data.file_url);

🐘 PHP

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://udcshare.com/api/v1/upload",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: udc_votre_cle_ici"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("document.pdf")]
]);
$response = json_decode(curl_exec($curl));
echo "Lien : " . $response->file_url;

📟 Bash / cURL

# Uploader un fichier
curl -X POST https://udcshare.com/api/v1/upload \
  -H "X-API-Key: udc_votre_cle_ici" \
  -F "file=@document.pdf"

# Voir votre compte
curl https://udcshare.com/api/v1/account \
  -H "X-API-Key: udc_votre_cle_ici"

Codes d'erreur

En cas d'erreur, l'API renvoie toujours un JSON avec un champ error expliquant le problème.

{ "error": "Description du problème" }

Code HTTP	Signification	Que faire ?
200	✅ Succès	—
400	Requête invalide	Vérifiez vos paramètres
401	Clé API manquante ou invalide	Vérifiez votre clé API
403	Abonnement expiré ou plan insuffisant	Renouvelez votre abonnement
404	Fichier introuvable	Vérifiez l'ID du fichier
413	Fichier trop volumineux	Réduisez la taille ou upgradez votre plan
429	Trop de requêtes	Patientez ou upgradez votre plan
500	Erreur serveur	Réessayez ou contactez le support