APIs & Scopes
La page APIs & Scopes liste tous les endpoints de l'API Zoho CRM utilisés par le dashboard Zepiq, avec leurs scopes d'autorisation requis. Elle permet d'auditer les autorisations accordées à votre connexion CRM.
Accès à la page
Allez dans Sécurité & Audit → APIs & Scopes (?tab=apis).
Comprendre les scopes OAuth
Un scope est une permission que vous accordez à Zepiq lors de la connexion OAuth. Sans le scope approprié, l'endpoint correspondant retourne une erreur 403 (accès refusé).
| Scope | Accès accordé |
|---|---|
ZohoCRM.modules.ALL | Lecture de tous les modules CRM (contacts, leads, deals, comptes…) |
ZohoCRM.users.READ | Lecture des utilisateurs, rôles et profils |
ZohoCRM.org.READ | Informations sur l'organisation Zoho |
ZohoCRM.settings.ALL | Workflows, cadences, règles d'affectation, picklists, templates |
ZohoCRM.bulk.READ | Export de données en masse |
Colonnes affichées
| Colonne | Description |
|---|---|
| Endpoint | URL de l'API Zoho appelée |
| Méthode | GET, POST, PUT, DELETE |
| Scope requis | Scope OAuth nécessaire pour cet endpoint |
| Statut | Autorisé (scope présent) ou Non autorisé (scope manquant) |
| Dernière utilisation | Date du dernier appel depuis le dashboard |
Filtres disponibles
- Filtrer par scope
- Filtrer par statut (autorisé / non autorisé)
- Rechercher par nom d'endpoint
Scope manquant — que faire ?
Si un endpoint affiche le statut Non autorisé, votre connexion CRM ne possède pas le scope requis. Solution :
- Allez dans Connexions CRM (
?tab=crm-connections) - Cliquez sur Reconnecter à côté de la connexion concernée
- Dans la fenêtre OAuth Zoho, autorisez les nouvelles permissions
- Revenez sur la page APIs — le statut passe à Autorisé
Badge "Reconnexion requise"
Quand un nouveau scope est nécessaire (après une mise à jour de Zepiq), un badge amber Reconnexion requise s'affiche dans la sidebar. Reconnectez votre CRM pour débloquer les nouvelles fonctionnalités.
Questions fréquentes
Pourquoi certains endpoints sont-ils en statut "Non autorisé" ? Votre token OAuth a été créé avant que ce scope soit ajouté à Zepiq. Une reconnexion suffit pour l'activer.
Est-ce que Zepiq peut modifier mes données Zoho ? Par défaut, Zepiq opère en lecture seule. Les scopes READ et ALL sont requis pour certaines fonctionnalités de lecture avancée — aucune donnée n'est modifiée sans action explicite.
Comment savoir quels scopes sont actuellement actifs ? La colonne Statut indique en temps réel les scopes autorisés pour votre connexion active.
L'API retourne une erreur 401 : votre token a expiré. Reconnectez votre compte CRM depuis Connexions CRM → Reconnecter.
L'API retourne une erreur 403 : scope insuffisant. Consultez la colonne Scope requis pour identifier la permission manquante, puis reconnectez.