📚 Glossaire
Termes utilisés dans toute la documentation multi-plateformes.
| Terme | Définition | Qui le crée | Quand l'utiliser |
|---|---|---|---|
| Clé API | Secret pour l'intégration app/SDK | Plateforme client Azeoo | initialize(apiKey) |
| Token SDK | Jeton de courte durée pour les appels backend SDK | SDK (après initialize réussi) | Interne ; vous le touchez rarement |
| JWT utilisateur | Jeton prouvant l'utilisateur connecté | Votre backend / système d'auth | connect / connectUser |
| Id profil | Chaîne id utilisateur Azeoo | Renvoyé par connect | À stocker si votre app doit référencer l'utilisateur |
| Connecteur | Lien optionnel vers resamania2 / deciplus | Configuré sur la clé API dans la plateforme client | Options initialize lorsque la clé a des connecteurs |
initialize vs connect
| initialize | connect | |
|---|---|---|
| Rôle | Démarrer le moteur SDK, échanger la clé API | Attacher l'utilisateur connecté |
| Utilisateur | Aucun | Obligatoire (JWT + profil) |
| Quand appeler | Au démarrage de l'app (ou après dispose) | Après votre flux de login |
| Rappeler quand | Clé API ou config globale change | L'utilisateur change de compte |
Erreurs fréquentes
| Erreur | Correctif |
|---|---|
Passer userId à connect | Passer uniquement JWT + genre + taille + poids |
| JWT admin/test en production | Utiliser un JWT émis par votre backend |
Afficher l'UI SDK avant connect | Attendre le succès de connect |
Appeler initialize sur chaque écran | Une fois par processus (sauf si vous dispose) |