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
  } 
}