- Intégrations
- Personnaliser l'intégration
- Générer des jetons API
Générer des jetons API
Comment générer des jetons API obligatoires pour les intégrations avec SafetyCulture ?What are the differences between service user and user API tokens?
Service user and user API tokens offer flexible ways to connect external tools to SafetyCulture.
Service user API tokens are best suited for long-term or shared integrations where access should stay the same regardless of user changes. You can set their permissions, which makes them ideal for stable, system-level connections.
User API tokens are suitable for one-off tasks, personal workflows, or scenarios where access needs to reflect a specific user's permissions or group and site memberships.
Choosing the correct token type ensures your integration runs smoothly while matching your organization's security and access needs.
Functionality | Service user API token | User API token |
|---|---|---|
Ownership | Created for a service user (system-based or integration-focused) | Created by an individual user |
Login | Cannot be used to log in | Can be used to log in |
Permissions | Assigned for each service user | Inherits the user’s permission set |
Group and site access control | Not supported | Inherits access from the user |
Integrations | Designed for long-term or shared integrations | Suited for short-term or personal use |
Token stability | Not affected by user changes | Will expire if user is deactivated or exits the organization |
Activity logs | Shows the service user name | Shows the individual user’s name |
Visibility | Not shown in the user list | Visible in user settings |
Billing | Does not count toward seat billing | Counts toward assigned user seat |
Each user can create up to 10 active user API tokens. Whereas, each organization can have up to 20 active service user tokens.
If you belong to multiple organizations, you need to create separate API tokens for your integrations. This applies to both service user and user API tokens.
Veuillez noter que les jetons API expirent après 30 jours d'inactivité, date à laquelle vous devrez générer un nouveau jeton pour que vos intégrations continuent à fonctionner avec SafetyCulture.
If your organization uses single sign-on (SSO) and does not allow non-SSO logins, you may not be prompted to enter a password when you generate a new user API token.
Générer un token API
Cliquez sur votre nom d'utilisateur en bas à gauche de la page et sélectionnez Mon profil.
Cliquez sur
Paramètres en haut à droite de la page.Sélectionnez Jetons API en haut à droite de la page.
Cliquez sur Générer un jeton API en haut à droite de la page.
Dans la fenêtre contextuelle, donnez-un nom au jeton et saisissez votre mot de passe. Si votre organisation utilise l'authentification unique (SSO) et n'autorise pas les connexions non SSO, vous ne devriez pas avoir à saisir un mot de passe.
Cliquez sur Générer.
Cliquez sur le jeton qui vient d'être généré pour le copier dans votre presse-papiers. Veillez à stocker le jeton en lieu sûr, car vous ne pourrez plus le voir une fois que vous aurez fermé la fenêtre contextuelle.
Retirer un jeton API
Cliquez sur votre nom d'utilisateur en bas à gauche de la page et sélectionnez Mon profil.
Cliquez sur
Paramètres en haut à droite de la page.Sélectionnez Jetons API en haut à droite de la page.
Cliquez sur
Annuler sur le côté droit du jeton.Dans la fenêtre contextuelle, cliquez sur Annulerpour confirmer.
FAQ
It depends on how your integration is set up.
For custom-built integrations (such as Workato, scripts, or direct API calls using a service user or user API token): Yes. Regenerating the token will break the integration until the replacement token is manually updated in your integration settings.
For built-in SafetyCulture integrations (such as Power BI, Microsoft Teams, or SharePoint): No. These integrations use system-managed tokens, so revoking or regenerating your API tokens will not affect them.
Cette page vous a-t-elle été utile?
Merci pour votre commentaire.