Installation¶
Le guide suivant décrit l'intégration de notre iframe dans votre application.
Glossaire¶
Attribut | Description |
---|---|
TOKEN | Votre token partenaire communiqué par notre équipe |
ORDER_TYPE | - order pour la création d'une commande |
- quotation pour la création d'un devis | |
PROFESSIONAL_TOKEN | Identifiant (token) du professionnel (uniquement disponible sur toolimo) |
Marque Diag&Go¶
Pour installer l'embed Diag&Go sur votre site il vous faut charger l'iframe suivante:
<iframe src="//embed.diagandgo.cloud/{TOKEN}/{ORDER_TYPE}" scrolling="no" frameborder="0" allowfullscreen="true" width="100%" height="500px" id="embed_wizard"></iframe>
Une erreur 401 ou 403 est remontée lorsqu'un token est incorrect.
Exemples:
Pour les prises de commande
<iframe src="//embed.diagandgo.cloud/bc7521e6-a9cf-4819-8d37-2874f2b7abff/order" ... id="embed_wizard"></iframe>
Pour les prises de devis
<iframe src="//embed.diagandgo.cloud/bc7521e6-a9cf-4819-8d37-2874f2b7abff/quotation" ... id="embed_wizard"></iframe>
Marque toolimo¶
L'argument PROFESSIONAL_TOKEN
est obligatoire pour les professionnels.
<iframe src="//embed.toolimo.cloud/{TOKEN}/{ORDER_TYPE}/{PROFESSIONAL_TOKEN}" scrolling="no" frameborder="0" allowfullscreen="true" width="100%" height="500px" id="embed_wizard"></iframe>
L'argument TOKEN
est obligatoire, il peut être transmis soit dans l'URL, soit par entête (header) avec la clé X-AUTH-TOKEN
.
<iframe src="//embed.toolimo.cloud/{ORDER_TYPE}/{PROFESSIONAL_TOKEN}" scrolling="no" frameborder="0" allowfullscreen="true" width="100%" height="500px" id="embed_wizard"></iframe>
Une erreur 401 ou 403 est remontée lorsqu'un des tokens est incorrect.
Exemples:
Pour les prises de commande avec le token dans l'url
<iframe src="//embed.toolimo.cloud/bc7521e6-a9cf-4819-8d37-2874f2b7abff/order/47761373-d4ba-424d-8a33-a9550fe40f92" ... id="embed_wizard"></iframe>
Pour les prises de commande avec le token dans l'url
<iframe src="//embed.toolimo.cloud/bc7521e6-a9cf-4819-8d37-2874f2b7abff/quotation/47761373-d4ba-424d-8a33-a9550fe40f92" ... id="embed_wizard"></iframe>
Dimensionnement automatique¶
Nous utilisons window.postMessage pour communiquer inter-domaine en toute sécurité.
À chaque modification de la hauteur le script ci-dessous applique un redimensionnement automatique sur l'iframe.
<script>
const iframeSelector = document.querySelector('iframe#embed_wizard');
addEventListener('message', function(event){
iframeSelector.style.height = event.data.height+'px';
});
</script>
Format du message¶
{
"data": {
"height": 500
}
}