Identidad
La IA sabe quién es. Cada sesión empieza con sus derechos reales — nunca más.
whoami
Devuelve el autor SPIP (id, nombre, estatus) asociado a la clave API actual.
Secciones
Reorganice el árbol de su sitio dictando, no haciendo clic.
list_rubriques
Lista las secciones. `parent` filtra por la sección madre (0 = raíz).
| Parámetro | Tipo | Obligación |
|---|---|---|
| parent | integer | null | opcional |
| limite | integer | opcional |
get_rubrique
Detalla una sección (título, descripción, texto, estatus, `lang` y `langue_choisie` — `oui` si el idioma es explícito, `non` si es heredado).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_rubrique | integer | obligatorio |
create_rubrique
Crea una sección.
| Parámetro | Tipo | Obligación |
|---|---|---|
| titre | string | obligatorio |
| id_parent | integer | opcional |
| descriptif | string | null | opcional |
| texte | string | null | opcional |
| lang | string | null | opcional |
update_rubrique
Modifica una sección. Solo se actualizan los campos proporcionados.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_rubrique | integer | obligatorio |
| titre | string | null | opcional |
| descriptif | string | null | opcional |
| texte | string | null | opcional |
set_rubrique_lang
Asigna el **idioma** de una sección (código ISO: `fr`, `en`, …) y lo marca como elegido explícitamente (`langue_choisie = oui`) — el equivalente de `set_article_lang` para las secciones.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_rubrique | integer | obligatorio |
| lang | string | null | opcional |
| heriter | boolean | opcional |
Artículos
De la primera línea a la publicación: redactar, corregir, mover, traducir, publicar — dentro del flujo SPIP que su equipo conoce.
list_articles
Lista los artículos.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_rubrique | integer | null | opcional |
| statut | string | null | opcional |
| recherche | string | null | opcional |
| limite | integer | opcional |
get_article
Detalla un artículo (todos los campos + autores vinculados).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
create_article
Crea un artículo en una sección.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_rubrique | integer | obligatorio |
| titre | string | null | opcional |
| soustitre | string | null | opcional |
| descriptif | string | null | opcional |
| chapo | string | null | opcional |
| nom_site | string | null | opcional |
| url_site | string | null | opcional |
| texte | string | null | opcional |
update_article
Modifica un artículo. Solo se actualizan los campos proporcionados.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
| titre | string | null | opcional |
| soustitre | string | null | opcional |
| descriptif | string | null | opcional |
| chapo | string | null | opcional |
| nom_site | string | null | opcional |
| url_site | string | null | opcional |
| texte | string | null | opcional |
| id_rubrique | integer | null | opcional |
set_article_author
Asigna un autor a un artículo (o lo retira con `retirer=True`).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
| id_auteur | integer | obligatorio |
| retirer | boolean | opcional |
set_article_status
Cambia el estatus de flujo de trabajo de un artículo.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
| statut | string | obligatorio |
move_article
Mueve un artículo a otra sección (`id_rubrique` de destino).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
| id_rubrique | integer | obligatorio |
make_article_page
Convierte un artículo en **página única** (plugin SPIP «Pages»): el artículo sale de toda sección (`id_rubrique = 0`) y se sirve con la plantilla dedicada del plugin — típico para el aviso legal, la página de contacto, etc.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
set_article_lang
Asigna el **idioma** de un artículo (código ISO: `fr`, `en`, `pt_br`, …) y lo marca como elegido explícitamente (`langue_choisie`).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
| lang | string | obligatorio |
set_article_translation
Designa un artículo como **traducción de otro** (grupo de traducción compartido vía `id_trad`), lo que alimenta la navegación entre idiomas y el **hreflang**.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
| id_traduction_de | integer | null | opcional |
| retirer | boolean | opcional |
trash_article
Envía un artículo a la papelera (estatus «poubelle»).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | obligatorio |
Más fácil de probar que de leer.
Pida una clave de prueba y hágale hacer todo esto en nuestro sitio de demostración.
FAQ (JSON-LD)
FAQ emitidas como datos estructurados FAQPage: sus contenidos se vuelven citables por los buscadores y las IA.
get_faq
Lee la **FAQ** de un artículo (`id_article`) o de una sección (`id_rubrique`) — funcionalidad del plugin «Datos estructurados GEO (JSON-LD)», que debe estar activo en el sitio.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | null | opcional |
| id_rubrique | integer | null | opcional |
set_faq
**Reemplaza** la FAQ de un artículo (`id_article`) o de una sección (`id_rubrique`) — se requiere el plugin «Datos estructurados GEO (JSON-LD)».
| Parámetro | Tipo | Obligación |
|---|---|---|
| questions | array | obligatorio |
| id_article | integer | null | opcional |
| id_rubrique | integer | null | opcional |
Mediateca
Añada, ordene y encuentre imágenes y documentos sin salir de la conversación.
add_document_from_url
Añade un documento/imagen a SPIP desde una **URL** (ideal para una imagen generada por DALL·E, o cualquier enlace): el archivo se **descarga** en SPIP y se adjunta a un artículo (`id_article`) o a una sección (`id_rubrique`).
| Parámetro | Tipo | Obligación |
|---|---|---|
| url | string | obligatorio |
| id_article | integer | null | opcional |
| id_rubrique | integer | null | opcional |
| titre | string | null | opcional |
| descriptif | string | null | opcional |
| credits | string | null | opcional |
| mode | string | opcional |
add_document_from_data
Añade un documento/imagen desde **datos base64**, adjuntado a un artículo o a una sección. **Reservado a archivos pequeños (≲ 10 KB).**
| Parámetro | Tipo | Obligación |
|---|---|---|
| filename | string | obligatorio |
| content_base64 | string | obligatorio |
| id_article | integer | null | opcional |
| id_rubrique | integer | null | opcional |
| titre | string | null | opcional |
| descriptif | string | null | opcional |
| credits | string | null | opcional |
| mode | string | opcional |
| taille_attendue | integer | null | opcional |
| sha256 | string | null | opcional |
list_documents
Lista la mediateca (documentos e imágenes).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_article | integer | null | opcional |
| id_rubrique | integer | null | opcional |
| media | string | null | opcional |
| extension | string | null | opcional |
| mode | string | null | opcional |
| recherche | string | null | opcional |
| limite | integer | opcional |
| offset | integer | opcional |
get_document
Detalla un documento y **resuelve su ubicación** a través del conector.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_document | integer | obligatorio |
download_document
Descarga el **binario** de un documento local y lo devuelve codificado en base64.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_document | integer | obligatorio |
unlink_document
**Desvincula** un documento de un artículo (`id_article`) o de una sección (`id_rubrique`) **sin eliminarlo**: el archivo y su ficha permanecen en la mediateca SPIP, y sus vínculos con otros objetos se conservan.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_document | integer | obligatorio |
| id_article | integer | null | opcional |
| id_rubrique | integer | null | opcional |
delete_document
Elimina un documento de la mediateca.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_document | integer | obligatorio |
| definitif | boolean | opcional |
Formularios
Cree y explote sus formularios Formidable — preguntas, respuestas, exportación CSV. Si el plugin está instalado en su sitio.
list_forms
Lista los formularios Formidable del sitio, con su número de respuestas (sin contar la papelera).
| Parámetro | Tipo | Obligación |
|---|---|---|
| statut | string | null | opcional |
| recherche | string | null | opcional |
| limite | integer | opcional |
get_form
Detalla un formulario Formidable, por `id_formulaire` o por `identifiant` (slug).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_formulaire | integer | null | opcional |
| identifiant | string | null | opcional |
create_form
Crea un formulario Formidable (reservado a los administradores). El formulario se crea con estatus «prop»: publíquelo después vía `set_form_status`.
| Parámetro | Tipo | Obligación |
|---|---|---|
| titre | string | obligatorio |
| saisies | array | obligatorio |
| identifiant | string | null | opcional |
| descriptif | string | null | opcional |
| message_retour | string | null | opcional |
| traitements | object | null | opcional |
| apres | string | null | opcional |
| url_redirect | string | null | opcional |
update_form
Modifica un formulario Formidable. Solo se actualizan los campos proporcionados; `saisies` es un **reemplazo total** — relea la estructura vía `get_form` y devuelva la lista completa (conservando los `identifiant` de los campos para su seguimiento).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_formulaire | integer | obligatorio |
| titre | string | null | opcional |
| saisies | array | null | opcional |
| identifiant | string | null | opcional |
| descriptif | string | null | opcional |
| message_retour | string | null | opcional |
| traitements | object | null | opcional |
| apres | string | null | opcional |
| url_redirect | string | null | opcional |
| confirmer_perte_champs | boolean | opcional |
set_form_status
Cambia el estatus de un formulario Formidable.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_formulaire | integer | obligatorio |
| statut | string | obligatorio |
list_form_responses
Lista las respuestas recibidas por un formulario Formidable (metadatos: fecha, autor, estatus — no el detalle de los campos, véase `get_form_response`).
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_formulaire | integer | obligatorio |
| statut | string | opcional |
| date_debut | string | null | opcional |
| date_fin | string | null | opcional |
| limite | integer | opcional |
| offset | integer | opcional |
get_form_response
Detalla una respuesta a un formulario Formidable: metadatos (fecha, autor, estatus) y `champs` — lista `{nom, label, saisie, valeur}` con las etiquetas resueltas desde la estructura del formulario.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_reponse | integer | obligatorio |
set_form_response_status
Cambia el estatus de una respuesta Formidable (moderación): `publie` | `prop` | `refuse` | `poubelle`. Pasar una respuesta de `poubelle` a `publie` la restaura. (`attente` está reservado a la validación por correo y se rechaza.)
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_reponse | integer | obligatorio |
| statut | string | obligatorio |
delete_form_response
Elimina una respuesta a un formulario Formidable.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_reponse | integer | obligatorio |
| definitif | boolean | opcional |
export_form_responses
Exporta las respuestas de un formulario Formidable en **CSV** (contenido de texto devuelto en `contenu`), mediante la exportación nativa del plugin.
| Parámetro | Tipo | Obligación |
|---|---|---|
| id_formulaire | integer | obligatorio |
| statut | string | opcional |
| date_debut | string | null | opcional |
| date_fin | string | null | opcional |
| cle_ou_valeur | string | opcional |