Découvrez où se trouve votre clé API Karbon dans Karbon et comment créer votre premier appel vers un point final dans Postman.

Les applications personnalisées qui interagissent avec l'API Karbon auront besoin de la clé d'accès à l'API de votre locataire avant de pouvoir interagir avec vos données. Voici comment la trouver en trois étapes simples :

1. Enregistrez votre application

Rendez-vous sur https://developers.karbonhq.com et soumettez votre nouvelle application. L'application devra être approuvé avant que vous puissiez récupérer la clé d'accès à l'API de votre locataire.

2. Connectez-vous à Karbon et accédez aux paramètres de vos applications connectées

Connectez-vous à Karbon et allez dans « Paramètres » dans la barre latérale, puis cliquez sur « Applications connectées ».

3. Trouvez votre intégration personnalisée et cliquez sur « Gérer »

Votre clé API s'affichera sur la page suivante. Utilisez cette clé en conjonction avec votre jeton d'autorisation d'application pour interagir avec l'API de Karbon.

Remarque : N'oubliez pas de ne donner cette clé d'accès qu'aux personnes et aux applications en qui vous avez confiance.

Vous vous êtes inscrit à l'API Karbon et vous disposez de votre clé d'application et de votre clé API. Il est maintenant temps de passer à l'action. L'application de test d'API la plus courante semble être Postman, voici donc un aperçu de l'utilisation de cet outil.

1. Ouvrez Postman et commencez par télécharger la spécification OpenAPI à partir de developers.karbonhq.com.

Glissez-déposez la spécification OpenAPI téléchargée dans la boîte de dialogue d'importation de Postman.

Si tout a été saisi correctement, vous devriez voir une nouvelle collection dans Postman :

2. Ajout de l'accès et de la clé API

Nous allons créer un environnement et ajouter ces importantes clés d'accès dans des variables. Il existe des moyens encore plus sûrs de gérer ces clés et nous vous suggérons de les mettre en œuvre et de suivre les bonnes pratiques.

Editez la collection Karbon API 3.0 et ajoutez un type de Token Bearer d'autorisation.

Ajoutez la variable

que vous avez créée lorsque vous avez ajouté la variable dans l'environnement.

Veillez à définir votre baseUrl comme suit

Il ne nous reste plus qu'à ajouter la clé d'accès à l'en-tête :

Nous avons créé un préréglage qui est plus facile à gérer, mais vous pouvez l'ajouter à chaque point de terminaison si vous le souhaitez.

Et voilà, c'est parti! Nous avons simplement utilisé le point de terminaison Contacts avec la méthode GET et supprimé tous les paramètres.

3. Bon codage!