--- title: "Guide de l'API opérateur" slug: "using-the-operator-api" updated: 2026-10-22T14:33:56Z published: 2026-10-22T14:33:56Z canonical: "support.tulip.co/using-the-operator-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Guide de l'API opérateur *Découvrez comment configurer l’API opérateur* Advanced Content This article assumes previous experience with APIs. L’ajout d’opérateurs à votre site est nécessaire pour créer les utilisateurs qui exécuteront les applications développées dans Tulip. Vous pouvez créer des opérateurs de deux façons :* [La page Utilisateurs](https://support.tulip.co/docs/adding-users-and-managing-user-roles), située dans **les Paramètres*** En utilisant un système externe via l’API Tulip. La procédure ci-dessous explique comment utiliser l’API Tulip pour créer des opérateurs. ## Ajouter un jeton API d’opérateur Feature rename Prior to r383, Service Accounts were called "API Tokens". Dans votre instance Tulip, cliquez sur **l’icône de** votre **profil** dans le coin supérieur droit et sélectionnez « **Paramètres** ». ![Configuring Your Tulip Account Settings_124925135](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Configuring%20Your%20Tulip%20Account%20Settings_124925135.png) Sélectionnez « **API Tulip** », puis cliquez sur le bouton « **Créer un compte de service** » en haut à droite. ![Create%20API%20token1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token1.png) Dans le menu de création, attribuez un **nom** au jeton API et sélectionnez la portée `users:write`. Cliquez sur **Créer**. ![Create API Token](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20Token.gif) Note Make sure to save the Service Account information for the **API Key**, **Secret**, and **Authorization Header**. ## Utilisation de l’API Operator La section suivante explique comment créer un opérateur. Dans cet exemple, nous utiliserons [Postman](https://www.postman.com/) pour effectuer la création. Commencez par ajouter votre point de terminaison API à la requête POST. NOTE If you are using a global API key, you need to specify the workspace. If your API key is workspaced scoped, it is optional. *https://(nomdevotreenstanceici).tulip.co/api/v3/w/(espace de travail)/users* ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222496924.png) Ensuite, sous « Authorization », sélectionnez **« Basic Auth** » et saisissez la clé API comme **nom d’utilisateur**, ainsi que le secret API comme **mot de passe**. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png) Sous « Headers », ajoutez l’ **en-tête « Auth** ». ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497957.png) Dans le corps de la requête, formatez la requête pour qu'elle prenne en charge l'objet JSON. Le format générique de cette requête est le suivant : `{"role": "operator","name": "string","badge_id": "string"}` Le résultat ressemblera à ceci : ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499033.png) Cliquez sur **« Envoyer »** pour lancer la requête ; vous recevrez une réponse 201 indiquant que l'opération a réussi. Pour vérifier, vous pouvez consulter votre liste d'utilisateurs dans **les « Paramètres »** et vous assurer que l'utilisateur a bien été créé. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499593.png) Si la requête a échoué, vérifiez que la clé et le secret sont corrects. Pour plus d'informations sur les codes de réponse spécifiques, consultez [la section Introduction aux API](/r230/docs/introduction-to-apis). --- Avez-vous trouvé ce que vous cherchiez ? Vous pouvez également vous rendre sur [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) pour poser votre question ou voir si d'autres utilisateurs ont rencontré un problème similaire ! **JSON** **JSON (JavaScript Object Notation)** is a light-weight, text-based data format that is used to store and transfer data.