Identité
L’IA sait qui elle est. Chaque session commence par vos droits réels — jamais plus.
whoami
Retourne l'auteur SPIP (id, nom, statut) associé à la clé API courante.
Rubriques
Réorganisez votre plan de site en dictant, pas en cliquant.
list_rubriques
Liste les rubriques. `parent` filtre sur la rubrique parente (0 = racine).
| Paramètre | Type | Obligation |
|---|---|---|
| parent | integer | null | optionnel |
| limite | integer | optionnel |
get_rubrique
Détaille une rubrique (titre, descriptif, texte, statut, `lang` et `langue_choisie` — `oui` si la langue est explicite, `non` si héritée).
| Paramètre | Type | Obligation |
|---|---|---|
| id_rubrique | integer | requis |
create_rubrique
Crée une rubrique.
| Paramètre | Type | Obligation |
|---|---|---|
| titre | string | requis |
| id_parent | integer | optionnel |
| descriptif | string | null | optionnel |
| texte | string | null | optionnel |
| lang | string | null | optionnel |
update_rubrique
Modifie une rubrique. Seuls les champs fournis sont mis à jour.
| Paramètre | Type | Obligation |
|---|---|---|
| id_rubrique | integer | requis |
| titre | string | null | optionnel |
| descriptif | string | null | optionnel |
| texte | string | null | optionnel |
set_rubrique_lang
Affecte la **langue** d'une rubrique (code ISO : `fr`, `en`, …) et la marque comme explicitement choisie (`langue_choisie = oui`) — miroir de `set_article_lang` pour les rubriques.
| Paramètre | Type | Obligation |
|---|---|---|
| id_rubrique | integer | requis |
| lang | string | null | optionnel |
| heriter | boolean | optionnel |
Articles
De la première ligne à la publication : rédiger, corriger, déplacer, traduire, publier — dans le workflow SPIP que votre équipe connaît.
list_articles
Liste les articles.
| Paramètre | Type | Obligation |
|---|---|---|
| id_rubrique | integer | null | optionnel |
| statut | string | null | optionnel |
| recherche | string | null | optionnel |
| limite | integer | optionnel |
get_article
Détaille un article (tous les champs + auteurs liés).
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
create_article
Crée un article dans une rubrique.
| Paramètre | Type | Obligation |
|---|---|---|
| id_rubrique | integer | requis |
| titre | string | null | optionnel |
| soustitre | string | null | optionnel |
| descriptif | string | null | optionnel |
| chapo | string | null | optionnel |
| nom_site | string | null | optionnel |
| url_site | string | null | optionnel |
| texte | string | null | optionnel |
update_article
Modifie un article. Seuls les champs fournis sont mis à jour.
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
| titre | string | null | optionnel |
| soustitre | string | null | optionnel |
| descriptif | string | null | optionnel |
| chapo | string | null | optionnel |
| nom_site | string | null | optionnel |
| url_site | string | null | optionnel |
| texte | string | null | optionnel |
| id_rubrique | integer | null | optionnel |
set_article_author
Affecte un auteur à un article (ou le retire si `retirer=True`).
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
| id_auteur | integer | requis |
| retirer | boolean | optionnel |
set_article_status
Change le workflow d'un article.
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
| statut | string | requis |
move_article
Déplace un article dans une autre rubrique (`id_rubrique` cible).
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
| id_rubrique | integer | requis |
make_article_page
Transforme un article en **page unique** (plugin SPIP « Pages ») : l'article est sorti de toute rubrique (`id_rubrique = 0`) et servi par le squelette dédié du plugin — typique pour les mentions légales, la page contact, etc.
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
set_article_lang
Affecte la **langue** d'un article (code ISO : `fr`, `en`, `pt_br`, …) et la marque comme explicitement choisie (`langue_choisie`).
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
| lang | string | requis |
set_article_translation
Désigne un article comme **traduction d'un autre** (groupe de traduction partagé via `id_trad`), ce qui alimente la navigation entre langues et le **hreflang**.
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
| id_traduction_de | integer | null | optionnel |
| retirer | boolean | optionnel |
trash_article
Met un article à la corbeille (statut « poubelle »).
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | requis |
Plus simple à essayer qu'à lire.
Demandez une clé d'essai et faites-lui faire tout ça sur notre site de démonstration.
FAQ (JSON-LD)
Des FAQ émises en données structurées FAQPage : vos contenus deviennent citables par les moteurs et les IA.
get_faq
Lit la **FAQ** d'un article (`id_article`) ou d'une rubrique (`id_rubrique`) — fonctionnalité du plugin « Données structurées GEO (JSON-LD) », qui doit être actif sur le site.
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | null | optionnel |
| id_rubrique | integer | null | optionnel |
set_faq
**Remplace** la FAQ d'un article (`id_article`) ou d'une rubrique (`id_rubrique`) — plugin « Données structurées GEO (JSON-LD) » requis.
| Paramètre | Type | Obligation |
|---|---|---|
| questions | array | requis |
| id_article | integer | null | optionnel |
| id_rubrique | integer | null | optionnel |
Médiathèque
Ajoutez, rangez, retrouvez images et documents sans quitter la conversation.
add_document_from_url
Ajoute un document/image à SPIP depuis une **URL** (idéal pour une image générée par DALL·E, ou tout lien) : le fichier est **téléchargé** dans SPIP et rattaché à un article (`id_article`) ou une rubrique (`id_rubrique`).
| Paramètre | Type | Obligation |
|---|---|---|
| url | string | requis |
| id_article | integer | null | optionnel |
| id_rubrique | integer | null | optionnel |
| titre | string | null | optionnel |
| descriptif | string | null | optionnel |
| credits | string | null | optionnel |
| mode | string | optionnel |
add_document_from_data
Ajoute un document/image depuis des **données base64**, rattaché à un article ou une rubrique. **Réservé aux petits fichiers (≲ 10 Ko).**
| Paramètre | Type | Obligation |
|---|---|---|
| filename | string | requis |
| content_base64 | string | requis |
| id_article | integer | null | optionnel |
| id_rubrique | integer | null | optionnel |
| titre | string | null | optionnel |
| descriptif | string | null | optionnel |
| credits | string | null | optionnel |
| mode | string | optionnel |
| taille_attendue | integer | null | optionnel |
| sha256 | string | null | optionnel |
list_documents
Liste la médiathèque (documents et images).
| Paramètre | Type | Obligation |
|---|---|---|
| id_article | integer | null | optionnel |
| id_rubrique | integer | null | optionnel |
| media | string | null | optionnel |
| extension | string | null | optionnel |
| mode | string | null | optionnel |
| recherche | string | null | optionnel |
| limite | integer | optionnel |
| offset | integer | optionnel |
get_document
Détaille un document et **résout son emplacement** via le connecteur.
| Paramètre | Type | Obligation |
|---|---|---|
| id_document | integer | requis |
download_document
Télécharge le **binaire** d'un document local et le renvoie encodé en base64.
| Paramètre | Type | Obligation |
|---|---|---|
| id_document | integer | requis |
unlink_document
**Délie** un document d'un article (`id_article`) ou d'une rubrique (`id_rubrique`) **sans le supprimer** : le fichier et sa fiche restent dans la médiathèque SPIP, et ses rattachements à d'autres objets sont conservés.
| Paramètre | Type | Obligation |
|---|---|---|
| id_document | integer | requis |
| id_article | integer | null | optionnel |
| id_rubrique | integer | null | optionnel |
delete_document
Supprime un document de la médiathèque.
| Paramètre | Type | Obligation |
|---|---|---|
| id_document | integer | requis |
| definitif | boolean | optionnel |
Formulaires
Créez et dépouillez vos formulaires Formidable — questions, réponses, export CSV. Si le plugin est installé sur votre site.
list_forms
Liste les formulaires Formidable du site, avec leur nombre de réponses (hors corbeille).
| Paramètre | Type | Obligation |
|---|---|---|
| statut | string | null | optionnel |
| recherche | string | null | optionnel |
| limite | integer | optionnel |
get_form
Détaille un formulaire Formidable, par `id_formulaire` ou par `identifiant` (slug).
| Paramètre | Type | Obligation |
|---|---|---|
| id_formulaire | integer | null | optionnel |
| identifiant | string | null | optionnel |
create_form
Crée un formulaire Formidable (réservé aux administrateurs). Le formulaire est créé en statut « prop » : le publier ensuite via `set_form_status`.
| Paramètre | Type | Obligation |
|---|---|---|
| titre | string | requis |
| saisies | array | requis |
| identifiant | string | null | optionnel |
| descriptif | string | null | optionnel |
| message_retour | string | null | optionnel |
| traitements | object | null | optionnel |
| apres | string | null | optionnel |
| url_redirect | string | null | optionnel |
update_form
Modifie un formulaire Formidable. Seuls les champs fournis sont mis à jour ; `saisies` est un **remplacement total** — relire la structure via `get_form` et renvoyer la liste complète (en conservant les `identifiant` de saisies pour le suivi des champs).
| Paramètre | Type | Obligation |
|---|---|---|
| id_formulaire | integer | requis |
| titre | string | null | optionnel |
| saisies | array | null | optionnel |
| identifiant | string | null | optionnel |
| descriptif | string | null | optionnel |
| message_retour | string | null | optionnel |
| traitements | object | null | optionnel |
| apres | string | null | optionnel |
| url_redirect | string | null | optionnel |
| confirmer_perte_champs | boolean | optionnel |
set_form_status
Change le statut d'un formulaire Formidable.
| Paramètre | Type | Obligation |
|---|---|---|
| id_formulaire | integer | requis |
| statut | string | requis |
list_form_responses
Liste les réponses reçues par un formulaire Formidable (métadonnées : date, auteur, statut — pas le détail des champs, voir `get_form_response`).
| Paramètre | Type | Obligation |
|---|---|---|
| id_formulaire | integer | requis |
| statut | string | optionnel |
| date_debut | string | null | optionnel |
| date_fin | string | null | optionnel |
| limite | integer | optionnel |
| offset | integer | optionnel |
get_form_response
Détaille une réponse à un formulaire Formidable : métadonnées (date, auteur, statut) et `champs` — liste `{nom, label, saisie, valeur}` avec les labels résolus depuis la structure du formulaire.
| Paramètre | Type | Obligation |
|---|---|---|
| id_reponse | integer | requis |
set_form_response_status
Change le statut d'une réponse Formidable (modération) : `publie` | `prop` | `refuse` | `poubelle`. Repasser une réponse de `poubelle` à `publie` la restaure. (`attente` est réservé à la validation par email et refusé.)
| Paramètre | Type | Obligation |
|---|---|---|
| id_reponse | integer | requis |
| statut | string | requis |
delete_form_response
Supprime une réponse à un formulaire Formidable.
| Paramètre | Type | Obligation |
|---|---|---|
| id_reponse | integer | requis |
| definitif | boolean | optionnel |
export_form_responses
Exporte les réponses d'un formulaire Formidable en **CSV** (contenu texte renvoyé dans `contenu`), via l'export natif du plugin.
| Paramètre | Type | Obligation |
|---|---|---|
| id_formulaire | integer | requis |
| statut | string | optionnel |
| date_debut | string | null | optionnel |
| date_fin | string | null | optionnel |
| cle_ou_valeur | string | optionnel |