Le code 403 SCOPE_MISMATCH pour la recherche de tickets signifie que le jeton d'accès que vous avez envoyé ne comprend pas la portée (scope) de l'API Desk requise pour appeler le point de terminaison de recherche de tickets ; Zoho rejette la requête pour des raisons d'autorisation. Cela se produit généralement après un changement de portée, un rafraîchissement de jeton qui a perdu des portées, ou lorsqu'une application n'a jamais reçu les portées de recherche/ticket de Desk [3][4].
Ce que cela signifie
La couche d'autorisation de Zoho vérifie les portées OAuth associées au jeton porteur par rapport au point de terminaison de l'API que vous appelez. Le point de terminaison de recherche de tickets nécessite des portées spécifiques de recherche/ticket de Desk ; si le jeton ne possède pas ces portées, l'API renvoie 403 SCOPE_MISMATCH plutôt qu'une erreur de données ou de syntaxe [3]. L'erreur est un échec d'autorisation lié aux revendications de portée OAuth, et non à la syntaxe COQL ou de requête.
Causes courantes
- Votre client/jeton OAuth a été créé ou rafraîchi sans que les portées de recherche/ticket de Desk n'aient été demandées ou approuvées [3].
- L'utilisateur ou l'administrateur a révoqué l'autorisation de l'application ou supprimé les portées requises après le consentement initial [3][4].
- Vous avez rafraîchi/obtenu un jeton d'accès en utilisant un flux d'octroi différent (ou un client différent) qui ne demande pas les mêmes portées [4].
- Utilisation d'un jeton mis en cache de longue durée émis avant que vous n'ajoutiez la portée de recherche/ticket au client ; l'ancien jeton n'a jamais eu la nouvelle portée [3].
Comment corriger
- Confirmez les portées requises : vérifiez quelles portées de Desk le point de terminaison de recherche de tickets exige dans la documentation de l'API Zoho Desk ou dans vos notes d'intégration, puis listez les portées que votre application doit demander.
- Mettez à jour la requête OAuth : ajoutez les portées de recherche/ticket de Desk requises à votre URL d'autorisation ou au paramètre de portée dans la requête de jeton.
- Ré-consentez en tant qu'utilisateur/administrateur : ouvrez l'URL d'autorisation pour que l'utilisateur (ou l'administrateur de l'organisation si le consentement de l'administrateur est requis) ré-accorde l'ensemble des portées mises à jour. Pour l'accès au niveau de l'organisation, connectez-vous en tant qu'administrateur via Zoho Accounts > Applications autorisées.
- Générez un nouveau jeton d'accès : après le consentement, échangez le code d'autorisation (ou utilisez le flux de rafraîchissement qui demande les portées) pour obtenir un nouveau jeton d'accès et vérifiez ses portées. Ne réutilisez pas l'ancien jeton.
- Testez l'appel : réessayez la requête de recherche de tickets avec le nouveau jeton et confirmez que le code 403 disparaît. Enregistrez la revendication de portée du jeton pour le débogage futur.
Quand escalader
Si la ré-demande des portées et l'obtention d'un nouveau jeton ne résolvent pas le code 403, ouvrez un ticket de support auprès de Zoho Desk. Incluez votre ID client, la liste exacte des portées que vous avez demandées, l'heure de la requête échouée, ainsi que le point de terminaison et les en-têtes complets de l'API (masquez les secrets) ; le support Zoho pourra vérifier le consentement au niveau de l'organisation et les mappages de portées [3][4].