Clés API
Retyc expose une API publique qui permet d'intégrer vos outils (scripts, supervision, SIRH, GED...) avec votre organisation : consultation des membres, des transferts et des datarooms, automatisations. L'accès se fait par des clés API propres à l'organisation.
Réservé aux Owner et Admin.
Créer une clé
- Accédez à Dashboard > Organisation > Clés API
- Donnez un nom à la clé (ex. : "Monitoring")
- Choisissez sa durée de validité : la clé expire automatiquement
- Cochez les scopes à accorder
- Cliquez sur Créer la clé
Le secret de la clé est affiché une seule fois à la création : copiez-le immédiatement dans votre gestionnaire de secrets.
Les scopes
Chaque clé est limitée aux permissions que vous sélectionnez :
| Scope | Accès |
|---|---|
organization:read | Lire les informations et membres de l'organisation |
organization:write | Modifier l'organisation |
transfer:read | Lire les transferts |
transfer:write | Gérer les transferts |
dataroom:read | Lire les datarooms |
dataroom:write | Gérer les datarooms |
Accordez uniquement les scopes nécessaires à chaque usage : une clé de supervision n'a besoin que de scopes read.
Restriction par IP
En bas de la page, vous pouvez restreindre l'utilisation des clés API à une liste d'adresses IP autorisées. Activez l'option Restreindre les clés API aux IP autorisées, puis collez votre liste d'adresses. Une clé utilisée depuis une IP non listée est refusée.
Révoquer une clé
La section Clés existantes liste les clés actives avec leur expiration. Supprimez une clé pour révoquer immédiatement son accès.
Documentation de l'API
La référence complète de l'API publique (endpoints, schémas, authentification) est accessible via le bouton Documentation en haut de la page Clés API.
L'API publique ne peut pas déchiffrer vos fichiers : le chiffrement de bout en bout s'applique aussi aux intégrations. Les clés API donnent accès aux métadonnées et aux opérations de gestion, jamais au contenu en clair.