URL de base et environnements
Séparez clairement les URL de production, de staging et d'embed quand vous intégrez OmniLab.
1 min de lecture
Le staging et la production ont chacun leur propre hôte API et leurs propres identifiants.
Hôtes API
| Environnement | Hôte API | Exemple |
|---|---|---|
| Staging (UAT) | https://<subdomain>.api.uat.omnilab.studio | https://lindenhall.api.uat.omnilab.studio |
| Production | https://<subdomain>.api.omnilab.studio | https://lindenhall.api.omnilab.studio |
<subdomain> est le sous-domaine de votre compte, que votre Customer Success Manager vous confirme avec vos identifiants. C'est l'hôte qui détermine le compte visé par l'appel : un jeton ne fonctionne donc que sur l'hôte de son propre compte. Chaque chemin d'endpoint commence par /v1/.
Séparer trois notions d'URL
| Type d'URL | À quoi elle sert | Exemple |
|---|---|---|
| Hôte API | Demandes de jeton et appels API de serveur à serveur | https://lindenhall.api.omnilab.studio |
| Domaine d'expérience | Pages d'accueil, points de contact et embeds. Il peut s'agir de votre propre domaine personnalisé. | https://offers.lindenhall.example |
| URL de la page hôte ou du wrapper | Votre propre site, le wrapper de votre borne ou le conteneur de votre app | https://www.lindenhall.example/promo |
Une même intégration utilise souvent les trois. Les garder séparées facilite le diagnostic quand une demande de jeton fonctionne mais pas un embed, ou quand des webhooks de staging pointent vers la production.
Bonnes pratiques par environnement
- Ne réutilisez jamais les secrets de production en staging.
- Déclarez un endpoint webhook distinct dans chaque environnement.
- Testez d'abord en staging les flux de réservation, les annulations et les nouvelles tentatives des webhooks.
- Gardez les campagnes de test, les liens publics et les automatisations en aval séparés de la production.