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).