Découvrez comment configurer l’API opérateur
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, 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
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 ».
Sélectionnez « API Tulip », puis cliquez sur le bouton « Créer un compte de service » en haut à droite.
Dans le menu de création, attribuez un nom au jeton API et sélectionnez la portée users:write. Cliquez sur Créer.
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 pour effectuer la création.
Commencez par ajouter votre point de terminaison API à la requête POST.
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
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.
Sous « Headers », ajoutez l’ en-tête « Auth ».
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 :
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éé.
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.
Avez-vous trouvé ce que vous cherchiez ?
Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres utilisateurs ont rencontré un problème similaire !