Médias (images)

La médiathèque regroupe les images d'un site (logo, photos des sections, image de partage). Une image envoyée reçoit une URL publique que vous placez ensuite dans un champ d'image d'une section, dans logo, favicon ou og_image.

L'objet média#

{
  "id": 31,
  "url": "https://monsiteo.com/storage/sites/7/202610/k3Jd8sPqLmZx0aBcDeFgHiJk.jpg",
  "name": "cornet-de-frites.jpg",
  "mime": "image/jpeg",
  "size": 384512,
  "width": 1600,
  "height": 1067,
  "alt": "Cornet de frites maison avec sauce andalouse",
  "created_at": "2026-10-26T09:30:00+00:00"
}

size est en octets. width et height valent null quand ils ne peuvent pas être lus (SVG notamment). alt est la description de l'image pour l'accessibilité et le référencement.

Lister les médias#

GET /v1/sites/{site}/media · Jeton

Les 500 images les plus récentes du site.

curl https://api.monsiteo.com/v1/sites/7/media \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "data": [ { "id": 31, "url": "https://monsiteo.com/storage/sites/7/202610/k3Jd8sPqLmZx0aBcDeFgHiJk.jpg", "name": "cornet-de-frites.jpg", "mime": "image/jpeg", "size": 384512, "width": 1600, "height": 1067, "alt": "Cornet de frites maison avec sauce andalouse", "created_at": "2026-10-26T09:30:00+00:00" } ] }

Erreurs : 403, 404.

Envoyer une image#

POST /v1/sites/{site}/media · Jeton · 60 requêtes par minute · multipart/form-data

curl -X POST https://api.monsiteo.com/v1/sites/7/media \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd" \
  -F "file=@cornet-de-frites.jpg" \
  -F "alt=Cornet de frites maison avec sauce andalouse"

Réponse 201 :

{ "data": { "id": 31, "url": "https://monsiteo.com/storage/sites/7/202610/k3Jd8sPqLmZx0aBcDeFgHiJk.jpg", "name": "cornet-de-frites.jpg", "mime": "image/jpeg", "size": 384512, "width": 1600, "height": 1067, "alt": "Cornet de frites maison avec sauce andalouse", "created_at": "2026-10-26T09:30:00+00:00" } }

Le fichier est renommé avec un nom aléatoire ; le nom d'origine est conservé dans name. L'image est enregistrée telle quelle (pas de recadrage ni de compression côté serveur) : optimisez vos photos avant l'envoi, 1600 à 2000 pixels de large suffisent.

Quota de stockage#

Le quota est calculé sur toutes les images du compte, tous sites confondus : 200 Mo en Gratuit, 2 Go en Site, 10 Go en Site + Novadesko. Au-delà :

{ "message": "Espace de stockage plein pour votre formule.", "upgrade": true }

Fichiers SVG#

Les SVG passent par un nettoyeur dédié qui retire les scripts, les attributs d'événements (onload...) et les références externes. Un fichier qui ne peut pas être nettoyé est refusé :

{ "message": "Ce fichier SVG est invalide et a été refusé." }

(code 422). Erreurs possibles : 402, 403, 404, 422 (format, taille), 429.

Supprimer un média#

DELETE /v1/media/{media} · Jeton

Supprime le fichier et l'entrée de la médiathèque. Seul le compte qui a envoyé l'image peut la supprimer.

curl -X DELETE https://api.monsiteo.com/v1/media/31 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "ok": true }

Attention Les sections qui utilisaient cette image gardent son URL, qui ne fonctionne plus : l'image n'apparaît plus sur le site. Remplacez-la dans les sections concernées avant de la supprimer.

Erreurs : 403, 404.