Authentification sur 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 méthode 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 enregistrées dans l’historique comme exécutées via automatisation).

Comment l’obtenir

Vous pouvez récupérer le workspace token lors de l’exécution d’un flux dans Hablla qui utilise un composant de l’API. Dans la réponse de la requête, il sera disponible dans l’en-tête Authorization.

📌 Exemple visuel :

Le champ Authorization contient le jeton que vous devrez utiliser. Important : remplacez toujours par token_aqui lors du partage d’exemples publics afin d’éviter les fuites.

Identifier l’ID de l’espace de travail

L’ID de l’espace de travail (exemple : 64e683e59a0a699241b5222c) est unique pour chaque 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_DE_L_ESPACE_DE_TRAVAIL>

Exemple de requête

curl "https://api.hablla.com/v2/workspaces/<ID_DE_L_ESPACE_DE_TRAVAIL>/persons?page=1&limit=50" \",
  -H "authorization: <VOTRE_JETON_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 robot)	❌ Non	✅ Oui