Les 15 portées des clés API et des connexions IA : ce que permet chaque portée, son nom dans le tableau de bord et ce qu’aucune clé API ne peut faire.
Les portées définissent ce qu’une clé API peut faire. Les mêmes 15 portées s’appliquent aussi aux assistants IA que vous connectez via MCP. Choisissez toujours uniquement les portées dont une application a réellement besoin.
Règles de base
- Chaque endpoint requiert exactement une portée
- Pour les clés API, write:X inclut automatiquement read:X – le tableau de bord l’indique : « write:X inclut automatiquement read:X »
- Si la portée manque, l’API répond 403 insufficient_scope et nomme la portée requise dans details.required_scope
- Les endpoints qui ne sont pas du tout ouverts aux clés API répondent aussi 403 insufficient_scope
- Les fonctions de propriétaire et d’admin comme les membres, la facturation ou la gestion des domaines ne sont accessibles avec aucune portée
Toutes les portées
Dans la boîte de dialogue « Créer une nouvelle clé API », vous choisissez « Lecture » ou « Écriture » pour chaque domaine ; la liste des clés affiche les noms de portée de la première colonne. La forme « Lecture · Pages » apparaît sur la page de consentement des applications IA et sous « Applications connectées ».
| Portée | Pour les applications IA | Permet |
|---|---|---|
| read:pages | Lecture · Pages | Lister et lire les pages, lire et valider le brouillon, lister les blocs, lire le SEO, lister les versions, récupérer les types de blocs |
| write:pages | Écriture · Pages | Créer et modifier des pages (handle compris), modifier le brouillon, créer, modifier, supprimer et réordonner des blocs, modifier le SEO, la visibilité, publier, restaurer une version, liens d’invitation pour les pages privées |
| read:links | Lecture · Liens | Lister et lire les liens d’une page |
| write:links | Écriture · Liens | Créer, modifier, supprimer et réordonner des liens |
| read:assets | Lecture · Ressources | Lister les ressources |
| write:assets | Écriture · Ressources | Téléverser et supprimer des ressources, téléversements pour une page |
| read:forms | Lecture · Formulaires | Lire les formulaires, le résumé, lister les envois et les exporter en CSV (export à partir de Creator Pro) |
| write:forms | Écriture · Formulaires | Créer, modifier et supprimer des formulaires |
| read:stats | Lecture · Statistiques | Statistiques de page et d’espace de travail (résumé, séries temporelles, comparaison, liens, widgets, conversions, meilleures pages), historique push et utilisation push |
| read:workspaces | Lecture · Espaces de travail | Lire les fonctions de l’offre, l’utilisation, la liste des membres et les réglages de l’espace de travail, lister les domaines, lister et lire les modèles, lister et lire les secrets de callback (sans le secret en clair) |
| write:workspaces | Écriture · Espaces de travail | Actuellement aucun endpoint au-delà de read:workspaces |
| read:donations | Lecture · Paiements des soutiens | Totaux des paiements des soutiens de l’espace de travail (paiements via le bloc « Soutenir ») |
| read:short_links | Lecture · Liens courts | Lister et lire les liens courts |
| write:short_links | Écriture · Liens courts | Créer, modifier et supprimer des liens courts |
| write:templates | Écriture · Modèles de l’espace de travail | Créer, modifier et supprimer vos propres modèles d’espace de travail (ils se lisent avec read:workspaces), voir Modèles personnalisés |
Les endpoints qui relèvent de chaque portée sont indiqués dans Endpoints par domaine.
Ce qu’aucune clé API ne peut faire
- Supprimer des pages
- Créer des liens d’aperçu du brouillon
- Répartitions des statistiques par appareil, pays, référent et UTM
- Envoyer des notifications push et gérer les règles push
- Connecter ou déconnecter des intégrations
- Gérer les webhooks
- Ajouter, vérifier, activer, désactiver ou supprimer des domaines
- Gérer les membres, les invitations et les rôles, transférer la propriété
- Modifier les réglages de l’espace de travail, la facturation
- Créer, modifier, régénérer ou supprimer des secrets de callback
- La liste des paiements des soutiens, les demandes d’accès aux données et l’anonymisation des envois de formulaire
- Gérer votre profil, les pages que vous suivez et les clés API elles-mêmes
Vous faites ces choses dans le tableau de bord.
Portées pour les assistants IA
Pour une connexion MCP, vous choisissez les mêmes portées sur la page de consentement. Il y a deux différences : d’abord, un droit d’écriture n’y inclut pas le droit de lecture – accordez donc les deux. Ensuite, votre rôle limite le choix : les lecteurs n’obtiennent que des droits de lecture (sans formulaires ni liens courts), les éditeurs tout sauf « Écriture · Espaces de travail », les liens courts et les modèles d’espace de travail. Plus d’infos dans Assistants IA : droits, sécurité et limites.
Combinaisons recommandées
| Cas d’usage | Portées |
|---|---|
| Reporting et tableaux de bord | read:stats, read:pages |
| Synchroniser des liens depuis un CMS ou une boutique | write:links, read:pages |
| Gérer et publier des pages automatiquement | write:pages, write:links |
| Liens de campagne depuis le CRM | write:short_links |
| Transmettre les leads des formulaires au CRM | read:forms |
| Déployer des modèles depuis un pipeline CI | write:templates, read:workspaces |
Cela pourrait aussi vous être utile
Vous n’avez rien trouvé ?
Dites-nous ce dont vous avez besoin, et notre équipe support vous aidera personnellement.