Aller au contenu
Content API

Votre agent IA participe. Vous gardez la clé.

Une API REST pour tout votre site, conçue pour des agents qui se trompent et réessaient. Avec des limites que vous fixez et une trace de chaque modification.

Réservez une démo gratuite
La documentation API interactive du back-office avec l'appel GET /context déplié et un exemple de réponse

  • 189

    opérations API

    Toutes décrites dans une seule spécification OpenAPI 3.1. Une route non documentée fait échouer le build.

  • 5

    profils de clé

    De la lecture seule au projet complet, avec un profil brouillon entre les deux.

  • 120

    écritures par minute

    Par clé, en plus de 600 lectures. Au-delà, votre agent reçoit un Retry-After clair.

  • 24h

    idempotence

    Si votre agent renvoie la même requête avec la même Idempotency-Key, aucun doublon n'est créé.

Sûr par conception

Les agents se trompent. L'API rattrape leurs erreurs.

Chaque couche est pensée pour un logiciel qui réessaie, devine et lit parfois de travers.

  • Une clé, un projet

    Une clé appartient à un seul site et porte une liste explicite de droits, avec une date d'expiration si vous le souhaitez.

  • Des profils adaptés

    Lecture seule, brouillon, publication, médias ou projet complet. Les données personnelles uniquement dans ce dernier.

  • Publier reste humain

    Sans droit de publication, tout ce que crée un agent arrive hors ligne. Vous relisez et publiez.

  • D'abord à blanc

    Avec dryRun=true, une modification est entièrement exécutée et validée, puis annulée. Vous voyez le résultat sans risque.

  • Pas d'écrasement à l'aveugle

    Envoyez l'ETag dans If-Match et une modification basée sur un contenu périmé est refusée. Le travail de vos collègues reste intact.

  • Réessayer sans doublons

    Une Idempotency-Key sur chaque création. Une requête répétée reçoit la première réponse.

  • Chaque modification journalisée

    Chaque écriture est consignée dans le journal d'audit, avec l'ancienne et la nouvelle valeur par champ et par langue, regroupées par exécution d'agent.

  • Des erreurs qu'un agent comprend

    Des codes d'erreur stables et toutes les violations dans une seule réponse, par champ. Votre agent ajuste son plan au lieu de deviner.

Comment travaille un agent

Découvrir d'abord, écrire ensuite.

Un agent n'a rien à deviner. Le modèle de contenu de votre site est décrit par l'API elle-même.

  1. Étape 1

    Contexte

    GET /api/context : quel projet, quelles langues, quels droits, quels modules et quelles limites.

  2. Étape 2

    Schéma

    GET /api/website/schema : quels blocs sont autorisés où, chaque champ décrit en JSON Schema.

  3. Étape 3

    Lire

    La page revient sous forme d'arbre réutilisable tel quel en écriture, avec un ETag par bloc.

  4. Étape 4

    Écrire

    D'abord à blanc, puis pour de vrai, avec If-Match et une Idempotency-Key. En cas de problème, vous recevez toutes les erreurs d'un coup et rien n'est écrit.

Essayer

Créez une clé, ouvrez la doc, essayez.

Un administrateur PageSquirrel crée une clé pour votre projet, avec le profil et la date d'expiration choisis. Le jeton ne s'affiche qu'une fois.

  • Swagger UI par projet, directement dans le back-office
  • Chaque appel testable en direct, y compris à blanc
  • La même spécification en fichier, en collection Postman et en script
La documentation API interactive du back-office avec l'appel GET /context déplié et un exemple de réponse
Ce qu'un agent peut faire

Tout votre site, pas seulement des articles.

  • Pages et blocs

    Créer, remplir, trier et déplacer pages, sections et blocs, dans chaque langue du site.

  • Médias

    Téléverser des images ou les importer en sécurité depuis une adresse https, avec texte alternatif par langue.

  • Menus

    Placer des pages dans le menu principal, le menu mobile ou le pied de page, dans le bon ordre.

  • Formulaires

    Modifier les champs, l'ordre et les destinataires de vos formulaires.

  • Réglages

    Profil SEO, coordonnées, bannière cookies, réglages Google, redirections et langues.

  • Modules

    Articles de blog, portfolio, logements et réservations, biens immobiliers, produits, stock et recettes.

Claude, MCP ou votre propre script.

L'API est conçue pour qu'une fine couche d'outils suffise : outils Claude, serveur MCP, LangChain ou simple script. Générez-les depuis la spécification OpenAPI ou commencez avec quelques-uns :

  • get_context et get_schema pour découvrir
  • read_page pour lire une page avec ses ETags
  • add_node et patch_node_fields pour écrire
  • upload_image_from_url pour les images
  • et ?dryRun=true pour tout prévisualiser

Le premier appel de tout agent : récupérer le contexte du projet.

curl https://pagesquirrel.com/api/context \
  -H "Authorization: Bearer psq_…" \
  -H "X-Agent-Run-Id: my-run"

Démarrez votre agent avec une clé « brouillon ». N'accordez la publication qu'une fois la confiance établie.

Testé sur nous-mêmes

Ce site a été construit par un agent, via l'API.

Chaque page, bloc, image et élément de menu de pagesquirrel.com a été créé via la Content API, par un agent Claude qui rejoue une description du site.

  • D'abord entièrement à blanc, puis pour de vrai
  • Chaque création avec une Idempotency-Key, chaque modification avec If-Match
  • Une deuxième exécution ne change plus rien
Sortie terminal de psq apply : la première exécution crée 224 éléments, la seconde ne trouve plus rien à modifier
Questions

Ce qu'il faut savoir avant de lâcher un agent.

Un agent peut-il casser mon site ?

C'est la clé qui en décide. Une clé « brouillon » ne peut rien publier ni supprimer : tout ce qu'elle crée arrive hors ligne jusqu'à ce que vous le publiiez. Un essai à blanc vous montre à l'avance ce qui se passerait.

Avec quels outils IA fonctionne-t-elle ?

Avec tout ce qui parle HTTP. Claude avec tool use, un serveur MCP que vous construisez sur la spécification OpenAPI, LangChain ou votre propre script. Aucun SDK requis.

Qui crée les clés ?

Un administrateur PageSquirrel crée la clé pour votre projet, avec le profil et la date d'expiration éventuelle que vous choisissez. Une clé ne peut jamais créer d'autres clés.

Puis-je annuler une modification faite par un agent ?

Il n'existe pas encore de bouton de restauration. Chaque modification figure toutefois dans le journal d'audit, avec l'ancienne et la nouvelle valeur par champ et par langue. Vous voyez toujours ce qui a changé et pouvez le rétablir. C'est pourquoi nous conseillons des clés « brouillon » pour les agents autonomes.

Un agent peut-il lire les données clients ?

Uniquement avec le profil « projet complet ». Les envois de formulaires, commandes et demandes de devis sont volontairement exclus des profils lecture, brouillon et publication.

Quelles limites s'appliquent ?

Par défaut 600 lectures et 120 écritures par minute et par clé, des images jusqu'à 2 Mo et 3000 × 3000 pixels (JPEG, PNG ou GIF). Chaque réponse indique à votre agent la marge restante.

Pour agences et développeurs

Découvrez l'API en direct dans le back-office.

Pendant la démo, nous créons ensemble une clé « brouillon » et laissons un agent construire une page.

Réservez une démo gratuite