Par défaut, si vous êtes membre d’un espace de travail en tant que Propriétaire, Administrateur ou intégrateur, vous pouvez créer une clé API depuis l’Espace développeur de l’application Web Universign.
Toutefois, si vous êtes Master Admin d’une Master Console, vous pouvez créer une clé API pour un espace de travail lié à votre Master Account.
Notez que cette opération n’est autorisée que pour les catégories de clients Entreprise et Intégrateur.
Pour créer une clé API pour un espace de travail lié à votre Master Account, envoyez une requête à POST /v1/api-keys et définissez le workspace_id.
Vous devez définir la clé API de la Master Console pour authentifier votre requête, comme dans l’exemple ci-dessous :
https://api.universign.com/v1/api-keys \
-H Authorization: Bearer apikey_my_master_account_apikey \
-d workspace_id=wsp_5X \
-d name=Test_API_key
workspace_id: l’identifiant de l’espace de travail lié au Master Account.
Notez que le nom de la clé API est facultatif. S’il n’est pas défini, la valeur par défaut est API key created on 2026-04-14T07:04:37.458Z.
{
"object": "apikey",
"id": "apk_5X",
"created_at": "2026-04-14T07:04:37.458Z",
"name": "Test_API_key",
"token": "apikey_xxx"
}
Notez que vous pouvez avoir jusqu’à 5 clés API par espace de travail.
Si vous supprimez une clé API, vous ne pourrez plus l’utiliser pour authentifier vos requêtes.
Recommandations
- Nommez explicitement votre clé API. Il vous sera plus facile d’identifier quelle clé API peut être supprimée, par exemple.
- Copiez votre clé API et stockez-la dans un endroit sécurisé de votre côté. Pour des raisons de sécurité, Universign ne stocke pas les clés API en texte clair.
Erreurs d’authentification
Si vous ne fournissez pas de clé API ou si vous en fournissez une invalide lorsque l’authentification est requise, vous recevrez une réponse 401 - Unauthorized.
Si la clé API que vous avez fournie ne vous donne pas accès à la ressource, vous recevrez une réponse 403 - Forbidden.
