URLs de base et environnements
Séparer clairement les URLs de production, de staging, et d'embarqué lorsque vous intégrez OmniLab.
Cet article explique comment séparer les URLs de production, de staging, et d'embarqué lorsque vous intégrez OmniLab. Les hostnames exacts sont spécifiques à chaque tenant, donc utilisez les valeurs provisionnées pour votre environnement au lieu de copier celles d'un autre déploiement.
Ce qu'OmniLab fournit généralement par environnement
| Environnement | Usage typique | Ce que vous devez recevoir |
|---|---|---|
| Staging | Construire, tester, et valider l'intégration | URL de base API, domaine d'expérience, credentials non production, et cibles webhook de staging |
| Production | Trafic participant réel | URL de base API de production, domaine d'expérience de production, credentials de production, et cibles webhook de production |
Séparer trois types d'URL
| Type d'URL | À quoi elle sert | Exemple de placeholder |
|---|---|---|
| URL de base API | Demandes de token et appels API server-to-server approuvés | https://<api-host> |
| Domaine d'expérience | Landing pages, touchpoints, et embeds | https://experience.example.com |
| URL de page hôte ou de wrapper | Votre site, votre borne, ou votre conteneur applicatif | https://www.example.com/promo |
Une même intégration utilise souvent les trois. Les distinguer clairement simplifie beaucoup le diagnostic lorsqu'une demande de token fonctionne mais pas une URL d'embed, ou lorsqu'un webhook de staging pointe par erreur vers l'infrastructure de production.
Règles sûres par environnement
- Ne réutilisez jamais des secrets de production en staging.
- Enregistrez des receivers webhook distincts par environnement.
- Testez les flux de booking, les annulations, et les retries webhook sur staging d'abord.
- Gardez les campagnes de test, les liens publics de test, et les automatisations aval séparés de la production.
Staging API base URL: https://staging-api.example-brand.com
Staging experience domain: https://staging-experience.example-brand.com
Production API base URL: https://api.example-brand.com
Production experience domain: https://experience.example-brand.comN'essayez pas de deviner les hostnames
Utilisez uniquement les hostnames fournis pour votre tenant. Certains déploiements utilisent des domaines de marque, des domaines délégués, ou une infrastructure spécifique par environnement qui ne correspondra pas à celle d'un autre client.
Pour aller plus loin
Authentification
Utiliser le bon endpoint de token et les bons credentials selon l'environnement.
Intégration par iframe
Utiliser le bon domaine d'expérience lorsque vous embarquez OmniLab dans une page web.
Délégation de domaine personnalisé
Préparer les domaines d'expérience de marque avant la mise en ligne.
Limites de débit
Concevoir un client qui se comporte correctement dans chaque environnement.