Vous opérez une plateforme numérique :
intégrez un de nos simulateurs
Vous avez un site qui informe ou accompagne les usagers ?
Intégrez facilement nos simulateurs pour offrir à votre audience un accès immédiat aux aides disponibles.
Deux options d'intégration
- iFrame : Intégration simple et rapide sur votre site web.
- API : Personnalisation avancée
Notre simulateur d'aides est intégrable de manière transparente en ajoutant une simple ligne de code à votre page web.
Le script d'intégration est accessible sur le dépôt hébergeant notre code.
Code d'intégration
Voici le script à intégrer sur votre site, qui créera l'iframe adéquate et l'ajoutera à votre page :
<script src="https://aides.beta.numerique.gouv.fr/assets/iframe-integration@1.0.1.js" data-simulateur="demenagement-logement" integrity="sha384-pWsCxETqtG8zVICx8IOmSGr/KVRL55v3OGmLHPe6M9SaaJTwHgBqkLyqL3JF0lg2" crossorigin="anonymous" defer></script>Prévisualisation
Voici un aperçu de l'intégration du simulateur sur votre site :
Options d'intégration
Vous pouvez personnaliser l'intégration en modifiant les attributs suivantes dans le tag <script> :
| Attribut | Description | Est obligatoire ? | Valeur par défaut |
|---|---|---|---|
data-simulateur | Identifiant du simulateur à afficher | Oui | - |
data-height | Hauteur initiale de l'iframe | Non | 600px |
data-log | Active les logs de débogage | Non | false |
data-wait-for-load | Attendre le chargement complet avant redimensionnement | Non | true |
Sécurité : Subresource Integrity (SRI)
Le code d'intégration inclut automatiquement la sécurité SRI (Subresource Integrity) qui garantit que le script n'a pas été modifié. Cette protection vérifie l'intégrité du fichier JavaScript avant son exécution.
Hash SRI actuel : sha384-pWsCxETqtG8zVICx8IOmSGr/KVRL55v3OGmLHPe6M9SaaJTwHgBqkLyqL3JF0lg2
Les attributs integrity et crossorigin="anonymous" sont automatiquement inclus dans le code d'intégration pour assurer cette sécurité.
Événements JavaScript
Le script d'intégration émet des événements JavaScript que vous pouvez écouter pour interagir avec le simulateur :
// Écoutez l'événement 'aides-simplifiees-ready' pour savoir quand l'iframe est prête
window.addEventListener('aides-simplifiees-ready', function() {
console.log('Le simulateur est prêt');
});
// Écoutez l'événement 'aides-simplifiees-message' pour recevoir les messages de l'iframe
window.addEventListener('aides-simplifiees-message', function(event) {
console.log('Message reçu:', event.detail);
});
Personnalisation avancée
Si vous souhaitez une intégration personnalisée du simulateur, vous pouvez contacter notre équipe à l'adresse aides.simplifiees@numerique.gouv.fr.
L'intégration par API vous permet de personnaliser l'expérience utilisateur et de bénéficier de fonctionnalités avancées.
Pour plus d'informations, contactez notre équipe à l'adresse aides.simplifiees@numerique.gouv.fr.