Agissez sur tous vos articles d'un coup API JSON admin, actions groupées (bulk)
API JSON admin actions groupées (bulk) une fonctionnalité du module Plugins & API interne de Clustraly. L'API JSON admin d'actions groupées (bulk) applique publier, brouillon, archiver ou corbeille à plusieurs articles en un seul appel POST sécurisé.
Sélectionnez une liste d'articles, choisissez publier, brouillon, archiver ou corbeille, et laissez un seul appel POST traiter tout le lot dans le strict respect de vos droits.
Une action, autant d'articles que nécessaire
Vous désignez une liste d'articles et vous leur appliquez d'un coup publier, brouillon, archiver ou corbeille. Fini le clic répété article par article : un seul appel traite tout le lot.
En retour, l'API vous dit précisément combien d'éléments ont été affectés et quelle action a été appliquée vous savez toujours ce qui s'est passé.
- Quatre actions en lot : publier, brouillon, archiver, corbeille
- Un seul appel POST pour toute une sélection
- Réponse chiffrée : nombre d'éléments affectés et action appliquée
Un endpoint unique, une réponse JSON nette
Vous adressez POST /admin/api/bulk avec l'action voulue et la liste d'ids. publish, draft et archive réalisent une mise à jour de statut en masse.
L'action publish renseigne la date de publication via COALESCE : une date déjà posée n'est jamais écrasée. La réponse revient en JSON, avec des codes HTTP adaptés.
- publish, draft, archive : UPDATE de statut en masse
- publish préserve une date de publication existante (COALESCE)
- Réponse uniformément JSON, codes HTTP adaptés
Des lots qui collent à votre quotidien éditorial
Publiez d'un coup toute une série préparée en brouillon. Repassez en brouillon un ensemble d'articles à retravailler. Archivez une rubrique entière en fin de cycle.
Envoyez à la corbeille un lot devenu obsolète récupérable si besoin. Chaque scénario tient en un seul appel, sans manipulation répétitive.
- Publier une série entière prête, en un geste
- Repasser un ensemble en brouillon pour retouche
- Archiver ou nettoyer une rubrique en fin de cycle
Supprimer sans jamais perdre : la corbeille restaurable
L'action delete n'efface rien définitivement. Chaque article part vers la corbeille restaurable via TrashService, jamais vers une suppression sèche.
Vous nettoyez une liste en masse tout en gardant, article par article, la possibilité de revenir en arrière.
- delete route vers la corbeille, pas de suppression définitive
- Chaque article reste restaurable après le lot
- Le ménage en masse sans risque de perte sèche
Vos droits décident, à l'article près
Avant d'agir, l'API filtre les ids que vous ne possédez pas si votre rôle n'est pas élevé (sans articles.edit_others) : vous n'agissez que sur ce qui vous revient.
L'appel exige la permission articles.create et un jeton CSRF, et il vit sous la limitation de débit du seau « api » et la session admin.
- Contrôle au niveau objet : filtrage des ids non possédés
- Permission articles.create + jeton CSRF exigés
- Regroupé sous limitation de débit et session admin
La publication reste sous contrôle
Publier en lot est en plus soumis au verrou éditorial articles.publish. Sans ce droit, l'action est refusée (403) et vous êtes invité à soumettre pour relecture plutôt qu'à publier directement.
L'IA prépare le lot ; vous ou votre relecteur gardez la décision finale de mise en ligne. Brouillon et archivage, eux, restent ouverts à votre rôle.
- publish soumis au verrou éditorial articles.publish
- Refus 403 avec invitation à soumettre pour relecture
- Brouillon et archivage restent accessibles à votre rôle
L'IA propose, vous décidez
Les actions groupées accélèrent le geste, jamais votre jugement. Vous choisissez le lot et l'action ; l'API applique, compte et vous rend la main. Ce que vous ne possédez pas reste hors de portée, la publication passe par votre verrou éditorial, et rien ne disparaît sans passer par une corbeille restaurable.
Questions fréquentes
Quelles actions puis-je appliquer en lot ?
Une suppression en masse est-elle définitive ?
Puis-je agir sur les articles d'autres auteurs ?
Pourquoi ma publication en lot est-elle refusée ?
Fonctionnalités liées
Découverte & liste des plugins
Scanner • Lister • Afficher statut • Afficher badges
DécouvrirValidation de manifeste & confinement de namespace
Valider • Confiner • Signaler erreurs
DécouvrirActivation & installation automatique
Activer • Installer • Migrer • Vérifier version CMS • Rejeter conflit • Journali
DécouvrirTraitez vos articles par lots, en gardant la main
Un appel, une action, toute une sélection avec le filtrage par propriété, le verrou éditorial de publication et la corbeille restaurable comme garde-fous. Les actions groupées font le geste répétitif à votre place ; vous, vous décidez du quoi et du quand.