Authentification dans l'API de Hablla

L’API Hablla utilise une authentification via Workspace Token, une approche recommandée pour les intégrations, les automatisations et les robots.

Authentification via Workspace Token (recommandé)

Le Workspace Token est un jeton directement lié à un espace de travail spécifique. C’est la forme d’authentification la plus pratique et la plus robuste pour les intégrations et les automatisations.

Principaux avantages :

• Permet l’accès à la plupart des routes de l’API.

• N’expire pas.

• Peut être utilisé en toute sécurité dans des environnements automatisés.

• Offre une traçabilité (les actions sont consignées dans l’historique comme exécutées via automatisation).

Comment l’obtenir

Vous pouvez obtenir le jeton d’espace de travail en accédant https://studio.hablla.com/ comme administrateur. Après vous être connecté, accédez au menu des paramètres via l’icône d’engrenage dans le coin supérieur droit. Dans les informations de l’entreprise, le jeton sera affiché.

📌 Exemple visuel :

Seul l’utilisateur de type Administrateur a accès à cette information. Important : remplacez toujours par token_ici lorsque vous partagez des exemples publics afin d’éviter les fuites.

Identification de l’ID de l’espace de travail

L’ID de l’espace de travail (exemple : 64e683e59a0a699241b5222c) est unique par client. Vous pouvez le trouver directement dans l’URL du navigateur lorsque vous accédez à votre environnement dans Hablla Studio :

https://studio.hablla.com/workspaces/<ID_DA_WORKSPACE>

Exemple de requête

curl "https://api.hablla.com/v2/workspaces/<ID_DA_WORKSPACE>/persons?page=1&limit=50" \
  -H "authorization: <VOTRE_TOKEN_ICI>" \
  -H "accept: application/json"

Conclusion

Type de jeton	Idéal pour	Actions traçables ?	Expiration	Recommandé ?
Workspace Token	Intégrations, automatisations, robots	✅ Oui (comme un robot)	❌ Non	✅ Oui