ZH

Fichiers partagés : ce que les utilisateurs d'une application s'échangent

Une application publiée sur jumphp.net peut laisser ses utilisateurs partager des fichiers entre eux, sans compte : les skins et les paroles de WinZik, les niveaux d'un jeu, des palettes, des modèles… Un fichier envoyé est public tout de suite ; le propriétaire du projet retire ce qui n'a rien à y faire.

Chaque application choisit ses sortes de fichiers (skin, lyrics, level…: lettres minuscules, chiffres et tirets, 20 caractères au plus).

L'API

Sur le site (pas sur l'origine des jeux), CORS ouvert : les pages des applications et les programmes installés l'appellent.

Requête Ce qu'elle fait
GET /api/apps/<slug>/shared/<sorte>?q=mots&limit=200 la liste, du plus récent au plus ancien ; q cherche dans le nom, le titre, l'artiste et l'auteur (tous les mots, accents ignorés)
GET /api/apps/<slug>/shared/<sorte>/<id> le fichier
POST /api/apps/<slug>/shared/<sorte> envoie un fichier : JSON {name, title?, artist?, author?, ext, data} (data en base64) → son entrée (201)

Une entrée : {id, name, title, artist, author, ext, size, sha256, at, downloads}.

Limites : 4 Mo par fichier, 300 Mo par application, 20 envois par heure et par adresse ; extensions zip, lyr, txt, json, png, ogg, mp3, wav (un .zip doit en être un). Le même fichier envoyé deux fois n'est gardé qu'une fois. Erreurs : 400 (mauvais envoi), 413 (trop gros), 429 (trop d'envois), 404 (application non publiée).

Depuis PHP (JumPHP)

Avec JumPHP\Http : jamais bloquant, la réponse arrive à une image suivante.

$base = 'https://jumphp.net/api/apps/mon-app/shared';
$this->engine->http()->get("$base/level?q=" . rawurlencode('château'))
    ->then(fn (HttpResponse $r) => $this->levels = $r->ok() ? $r->json()['items'] : []);

$this->engine->http()->post("$base/level", [
    'name' => 'Le donjon', 'author' => 'Ada', 'ext' => 'json', 'data' => base64_encode($json),
]);

WinZik en est l'exemple complet (apps/winzik/src/Core/Market.php : la marketplace des skins et des paroles, et les paroles cherchées toutes seules à chaque morceau).

Pour le propriétaire

Les outils MCP de jumphp.net : list_shared_files (les sortes, puis les fichiers d'une sorte) et delete_shared_file (retirer un fichier).