Publier via l'API & les Agents IA

# Aucune installation : trois requêtes HTTP suffisent
POST https://api.ezou.eu/v1/sites              # déclare les fichiers
PUT  <url pré-signée rendue par l’appel 1>      # transfère les octets
POST https://api.ezou.eu/v1/sites/{id}/finalize # scanne, met en ligne

# Le jeton est requis : il se crée gratuitement sur app.ezou.eu/tokens.
# Avec un jeton d’API — émis depuis votre tableau de bord — le site vous
# appartient : il apparaît dans votre liste, et peut être permanent.
curl -H "Authorization: Bearer <jeton>" ...

Sans jeton, l’API répond 401 account_required : la publication anonyme a existé — « sans compte, 24 h » — puis a été retirée. Le compte gratuit se crée avec une adresse email, sans mot de passe ni carte bancaire, et le jeton s’émet dans la foulée.

Avec un jeton, le site appartient au compte dès sa déclaration : il figure dans la liste des publications, peut être permanent, porter un sous-domaine choisi, et n’être supprimé que par son propriétaire.

# L’en-tête, sur n’importe quel appel de l’API
curl -H "Authorization: Bearer <votre jeton>" …

# Pour un serveur MCP, une variable d’environnement suffit
EZOU_TOKEN=<votre jeton>

L’obtenir

Dans le tableau de bord, onglet Jeton d’API. Il s’affiche une seule fois : le service n’en conserve que l’empreinte, jamais la valeur. Perdu, il faut en émettre un autre.

Un seul jeton par compte

En émettre un nouveau révoque le précédent : l’agent qui utilisait l’ancien reçoit alors 401 unauthorized jusqu’à ce qu’il reçoive le nouveau. La révocation est immédiate et gratuite ; elle ne touche pas aux sites déjà publiés, elle empêche d’en publier d’autres.

Émettre et révoquer sont des gestes réservés à une session humaine du tableau de bord. Un jeton ne peut pas se renouveler ni se révoquer lui-même — sans quoi un agent compromis couperait l’accès des autres.

Le connecteur MCP

Pour publier depuis une conversation Claude, le tableau de bord émet uneURL de connecteur : un serveur MCP distant, en HTTP streamable, dont le justificatif voyage dans le chemin. Elle expose onze outils —publish, list, status,set_options, update, versions,rollback, stage, promote,delete etsubprocessors — de quoi publier et gérer un lien après coup : remplacer le contenu sans changer l’adresse, corriger un seul fichier, revenir à une version précédente, la faire regarder en test avant qu’elle ne parte sur le domaine du client, changer qui peut l’ouvrir, allonger la durée, la rendre permanente.

update accepte patch: true : files ajoute ou remplace, delete retire, et tout le reste du site est conservé sans repasser par l’appel. status rend la liste des fichiers en ligne, de quoi savoir quoi corriger. La version précédente est archivée par défaut et reste récupérable par rollback ; keep_history: false l’efface. L’historique demande une offre payante : sur l’offre gratuite, chaque mise à jour efface la précédente.

publish et update acceptent aussi scan: true. Le contenu n’est pas analysé par défaut : c’est ce qui rend la mise en ligne immédiate. Demandée, l’analyse cherche secrets, NIR, IBAN et cartes, et refuse la publication en cas de secret. Une organisation peut l’imposer à tout son espace, et ce réglage-là ne se desserre pas depuis un appel.

set_options porte tous les réglages d’après-coup, et il en accepte plusieurs dans le même appel — les champs omis ne sont pas touchés :access (avec password ou domains),expiry et expires_at, slug etexact_slug, online pour suspendre un lien et le rétablir,keep_badge pour la mention « Publié avec ezou.eu », etdeploy: "direct" pour quitter le déploiement en deux temps. Il remplace les anciens set_access, set_expiry et set_slug : trois outils voisins pesaient dans la définition que chaque conversation relit, et « mets un mot de passe et garde-le une semaine » demandait deux appels.

La brancher, selon le client

La même URL sert les trois chemins : aucun paquet à installer, et rien d’autre à remplir que l’adresse.

# Claude.ai et Claude Desktop — « Ajouter un connecteur personnalisé »
# Champ « URL du serveur MCP distant » : collez l’URL, validez, c’est tout.

# Claude Code — une commande, transport HTTP
claude mcp add --transport http ezou "<votre URL de connecteur>"
# puis /mcp dans la conversation pour vérifier que les onze outils sont là

# Cursor et les autres clients MCP — ~/.cursor/mcp.json
{"mcpServers":{"ezou":{"url":"<votre URL de connecteur>"}}}

Ces trois formes écrivent le justificatif côté client, et c’est là qu’il fuit : une commande tapée entre dans l’historique du shell, un mcp.json de projet part au dépôt s’il n’est pas ignoré. Deux réflexes : passer l’URL par une variable d’environnement là où le client développe ${VAR}, et garder la configuration hors du dépôt. En cas de doute, révoquez : le tableau de bord réémet une URL en un geste, et l’ancienne cesse immédiatement de répondre.

Le justificatif est dans l’URL, et il est distinct du jeton d’API : ce dialogue n’offre aucun champ d’en-tête. Les deux se révoquent indépendamment, de sorte que couper le connecteur ne coupe pas vos agents en ligne de commande. Traitez cette URL comme un mot de passe : le service ne journalise jamais ce chemin, mais un client qui la stocke, lui, la conserve.

Par ce chemin, le contenu des fichiers arrive dans l’appel — un serveur distant ne lit pas votre disque. Le total est donc plafonné à 2 Mo, ce qui couvre largement une page ou un rapport autonome. Au-delà, passez par l’API : les octets vont directement au stockage sans transiter par le service.

Le privé, par défaut

Sur tous les chemins — interface, API, connecteur — l’accès par défaut estprivate, et c’est aussi ce que les outils recommandent à l’agent. L’adresse porte 130 bits d’entropie ; si vous choisissez un nom lisible, un suffixe aléatoire lui rend cette entropie. La limite reste celle d’une adresse : quiconque l’obtient peut l’ouvrir et la transmettre.

public ne rend pas un site indexable : le noindex est le défaut sur toutes les offres et tous les modes. « Public » veut dire « partageable par lien », pas « référencé ». Ce que le mode change, c’est qu’un nom choisi y reste tel quel — donc devinable.

Le référencement existe, mais il ne s’obtient par aucun appel : c’est une bascule par site, au tableau de bord, ouverte par l’offre Business. Elle exige un accès public — la bascule y fait passer le site, plutôt que d’indexer une adresse censée rester non listée — et une seule origine est référencée : le domaine personnalisé quand il est en service, l’adresse en.ezousite.eu sinon. Sur les offres Gratuit et Plus, la bascule n’existe pas et l’en-tête restenoindex, nofollow, noarchive, nosnippet : tant que le compte n’est pas Business, un sitemap.xml, un ping IndexNow ou deshreflang publiés sur un site ezou ne peuvent rien produire.

À traiter comme un mot de passe

Un jeton donne le droit de publier au nom du compte. Il n’a sa place ni dans un dépôt, ni dans un ticket, ni dans une conversation. Il ne permet en revanche pas de se connecter au tableau de bord, ni de changer d’offre.

# 1. Déclarer le site et les fichiers à envoyer
curl -X POST https://api.ezou.eu/v1/sites \
  -H "Authorization: Bearer $EZOU_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "expiry": "24h",
    "access": "private",
    "files": [{"path": "index.html", "size": 2048}]
  }'
# → {"site_id":"s_…", "upload":[{"path":"index.html","url":"https://…"}], "claim_token":"c_…"}

# 2. Envoyer chaque fichier directement vers son URL de stockage pré-signée
curl -T index.html "$UPLOAD_URL"

# 3. Déclencher le scan et mettre en ligne
curl -X POST https://api.ezou.eu/v1/sites/s_…/finalize \
  -H "Authorization: Bearer $EZOU_TOKEN"
# → {"url":"https://….ezousite.eu", "expires_at":"…", "pii_scan":{"status":"clean"}}

Un site servi par un domaine personnalisé a deux adresses : celle du service, <slug>.ezousite.eu, et le domaine. En publication directe — le défaut — les deux servent la dernière version. Le deux temps les sépare : la nouvelle version ne va que sur l’adresse du service, et le domaine garde la sienne jusqu’à ce que vous la promouviez. Un domaine personnalisé vérifiéest donc requis : sans lui il n’y a pas de seconde adresse, et le geste est refusé. Le domaine s’attache depuis le tableau de bord, à partir de l’offre Business.

Il n’y a pas d’interrupteur « activer » : le premier stagefige la production sur la version qu’elle servait à cet instant. C’est le seul chemin d’entrée dans le mode — deploy-mode n’accepte quedirect, qui en sort.

# 1. Ouvrir une mise à jour qui ne touchera pas le domaine
curl -X POST https://api.ezou.eu/v1/sites/s_…/update \
  -H "Authorization: Bearer $EZOU_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"stage": true, "files": [{"path": "index.html", "size": 2048}]}'
# → {"version":4, "upload":[…]} — le refus arrive ICI, avant les transferts

# 2. Après les PUT : mettre en ligne EN TEST. La version est explicite
#    en deux temps — la tête a pu reculer, la déduire écraserait une archive.
curl -X POST https://api.ezou.eu/v1/sites/s_…/finalize-update \
  -H "Authorization: Bearer $EZOU_TOKEN" \
  -d '{"version": 4, "stage": true, "keep_history": true}'
# → {"url":"https://….ezousite.eu", "staged":true,
#    "live_version":3, "live_url":"https://client.example"}

# 3. Regarder, puis publier sur le domaine
curl -X POST https://api.ezou.eu/v1/sites/s_…/promote \
  -H "Authorization: Bearer $EZOU_TOKEN" -d '{"version": 4}'
# → {"live_version":4, "live_url":"https://client.example", "staged":false}
#    Sans "version", promote met en ligne ce qui est en test.

# Remettre une version archivée en test, ou quitter le deux temps
curl -X POST https://api.ezou.eu/v1/sites/s_…/stage       -d '{"version": 2}'
curl -X POST https://api.ezou.eu/v1/sites/s_…/deploy-mode -d '{"mode": "direct"}'

Trois autres réponses changent dans ce mode.GET /v1/sites/{id}/versions ajoute un champ serving par version — live, staging ou live+staging — parce que « active » ne dit plus quelle adresse sert quoi, et rend live_versionet staged à côté de current_version.GET /v1/sites/{id}/stats sort les vues de l’adresse de test des compteurs du public et les rend à part, dans staging_hits : vos allers-retours de validation ne gonflent pas la courbe que lit le client. Etrollback réaligne les deux adresses : c’est le geste d’urgence, pas la correction d’une préproduction — pour celle-ci, unstage vers une autre version suffit.

Depuis une conversation, ce sont les outils stage et promote,stage: true sur update, et deploy: "direct" surset_options.