Important : Zendesk supprime les tokens API en tant que méthode d’authentification. À partir du 28 juillet 2026, les tokens inutilisés seront automatiquement désactivés. Le 30 avril 2027, tous les tokens API cesseront de fonctionner. Consultez Annonce de la suppression des tokens API en tant que méthode d’authentification pour les requêtes API. 

Question

Comment authentifier les demandes API avec l’une des API Zendesk ?

Réponse

Vous devez être un utilisateur vérifié pour effectuer des demandes API authentifiées. Pour authentifier les demandes API, vous pouvez utiliser l’authentification de base avec votre adresse e-mail et votre mot de passe, avec votre adresse e-mail et un token API, ou avec un token d’accès OAuth.

Toutes les méthodes d’authentification définissent différemment l’en-tête d’autorisation. Les identifiants envoyés dans la charge ou l’URL ne sont pas traités. Chaque option est répertoriée ci-dessous :

  • Authentification par token API
  • Authentification par token d’accès OAuth
  • Consultation de votre en-tête d’autorisation

Authentification par token API

Si vous utilisez un token API, vous pouvez combiner votre adresse e-mail et votre token API pour générer l’en-tête d’autorisation. Formatez la combinaison de l’adresse e-mail et du token API en une chaîne codée Base-64 . Pour un exemple de formatage de l’en-tête d’autorisation, reportez-vous au bloc de code ci-dessous.

Authorization: Basic {base-64-encoded email_address/token:api_token}

Authentification par token d’accès OAuth

Si vous utilisez OAuth pour l’authentification, formatez l’en-tête d’autorisation ainsi :

Authorization: Bearer oauth_access_token

Pour en savoir plus, consultez Utilisation de l’authentification OAuth avec votre application.

Consultation de votre en-tête d’autorisation

Avertissement : N'envoyez pas de tokens API en direct ou de production, de tokens d'accès OAuth, ni de mots de passe de compte à des outils d'inspection des demandes tiers ou à des corbeilles de demandes externes. L’exposition d’identifiants actifs à des services externes crée un risque de sécurité. Utilisez des tokens fictifs ou fictifs quand vous testez des en-têtes en externe.

Pour voir exactement ce que votre application envoie, utilisez une page tierce telle que Pipedream, anciennement RequestBin. Comparez vos en-têtes à ceux générés par un webhook en utilisant l ' authentification OAuth. Pointez le webhook vers votre URL m.pipedream.net et, sur la page Ajouter un webhook, cliquez sur Tester le webhook pour voir cela en action.

Ajouter une page Webhook au Centre d’administration montrant le bouton Tester le webhook

Une fois que la demande atteint votre requestb.in, elle ressemble à ce qui suit :

Détails de la corbeille de demande Pipedream montrant l’en-tête du porteur d’autorisation

La chaîne suivant Authorization: Bearer est la clé API fournie par RequestBin dans les paramètres de votre compte sous Accès programmatique.

Interface Web de décodage Base64 affichant les zones de saisie de chaînes codées et décodées

Si vous utilisez Python pour créer des demandes, configurez vos en-têtes de session comme suit :

session = requests.Session()
session.headers = {'Content-Type': 'application/json', 'Authorization': 'Basic Basic_64_encoded_code'}
Remarque : surveillez votre utilisation des API avec le tableau de bord d’utilisation des API et vérifiez les limites de débit éventuelles.

Pour en savoir plus, consultez la documentation destinée aux développeurs : Sécurité et authentification.

Traduction - exonération : cet article a été traduit par un logiciel de traduction automatisée pour permettre une compréhension élémentaire de son contenu. Des efforts raisonnables ont été faits pour fournir une traduction correcte, mais Zendesk ne garantit pas l’exactitude de la traduction.

Si vous avez des questions quant à l’exactitude des informations contenues dans l’article traduit, consultez la version anglaise de l’article, qui représente la version officielle.

Réalisé par Zendesk