Documentation développeur | API & Guide d’intégration - Implémentation hébergée

Vue d’ensemble

L’implémentation hébergée est une méthode d’intégration frontend-only de Go.cam, qui nécessite uniquement l’inclusion d’un script. Elle gère pour vous l’interface de vérification ainsi que les cookies de l’appareil, et applique la configuration liée à votre domaine (thème, langue, types de vérification, etc.).

Association du domaine et clés

• Chaque domaine doit être validé avant utilisation.
• Deux clés d’accès sont émises par domaine : une pour le développement et une pour la production.
• Les postbacks et la configuration sont liés au domaine.

Modes

• Implémentation automatique - Entièrement gérée : le contenu est flouté et une boîte de dialogue de vérification d’âge s’affiche automatiquement.
• Implémentation contrôlée - Vous contrôlez l’UX : vous floutez/défloutez le contenu et déclenchez vous-même la boîte de dialogue, tandis que Go.cam gère la vérification et les cookies.

Implémentation automatique

Incluez le script au début de votre (afin qu’il puisse flouter le contenu immédiatement et afficher la superposition de dialogue).

Ce que cela fait

• Floute le contenu de la page jusqu’à la fin de la vérification.
• Affiche une boîte de dialogue de confirmation d’âge avec un bouton pour démarrer la vérification.
• Crée un cookie persistant sur l’appareil du visiteur afin que les utilisateurs déjà vérifiés restent débloqués lors de leurs prochaines visites.
• Applique vos couleurs et votre langue configurées (modifiables via les paramètres de requête).

Paramètres de requête (dans l’URL du script)

• p (obligatoire) : votre identifiant de compte de vérification d’âge.
• key (obligatoire) : votre clé d’accès au domaine.
• language (optionnel, par défaut : en) : par ex. en, fr, de, es, it, pt, etc.
• background, foreground, buttonBackground, buttonForeground : valeurs hexadécimales utilisées pour personnaliser la boîte de dialogue.
• autoStart=1 (obligatoire) : démarre/attache automatiquement le flux hébergé au chargement.

Implémentation contrôlée

Incluez le script au début ou à la fin de votre . Dans ce mode, vous gérez vous-même quand flouter/déflouter et quand ouvrir la superposition.

Créez un bouton qui déclenche la vérification d’âge (l’exemple utilise #checkAgeButton) :

"checkAgeButton">Check my age
				

Configurez l’initialisation, le déclenchement et la gestion des événements :

// écouter un événement de succès
AvsGoCamHosted.event.on('success', () => {
	// l’âge a été vérifié avec succès, supprimer le flou du site
});

// écouter un événement d’erreur
AvsGoCamHosted.event.on('error', (error) => {
	// la vérification d’âge a échoué, réessayer
});

// ajouter une action au clic sur le bouton de vérification d’âge
document.querySelector('#checkAgeButton').addEventListener('click', () => {
	AvsGoCamHosted.showOverlay();
});

// initialiser la bibliothèque
AvsGoCamHosted.start();
				

Notes pour le mode contrôlé

• Vous êtes responsable de :
• L’application et la suppression du flou sur la page.
• Décider quand appeler AvsGoCamHosted.showOverlay() (par ex. au clic sur un bouton).
• Réagir aux événements success / error pour mettre à jour votre interface.
• Go.cam continue de :
• Exécuter le flux de vérification dans la superposition hébergée.
• Créer et gérer le cookie de vérification sur l’appareil.

Exemple : flouter / déflouter le contenu en mode contrôlé

1. Ajoutez le CSS pour l’effet de flou

.blurred {
	filter: blur(8px);
}

#blurOverlay {
	position: fixed;
	inset: 0;
	background: rgba(0, 0, 0, 0.6);
	backdrop-filter: blur(4px);
	z-index: 9998;
	display: flex;
	align-items: center;
	justify-content: center;
	color: #fff;
	font-size: 1.2em;
}

#checkAgeButton {
	z-index: 9999;
	position: relative;
	padding: 10px 20px;
	font-size: 1em;
	cursor: pointer;
}
				

2. Placez votre contenu dans un conteneur

<div id="pageContent" class="blurred">
  
  <h1>Bienvenue sur mon site webh1>
  <p>Ce contenu reste flouté jusqu’à ce que la vérification d’âge soit réussie.p>
div>


<div id="blurOverlay">
  <button id="checkAgeButton">Vérifiez votre âgebutton>
div>
				

3. Ajoutez la logique JavaScript

function applyBlur() {
	document.querySelector('#pageContent').classList.add('blurred');
	document.querySelector('#blurOverlay').style.display = 'flex';
}

function removeBlur() {
	document.querySelector('#pageContent').classList.remove('blurred');
	document.querySelector('#blurOverlay').style.display = 'none';
}

// si le cookie local n’est pas déjà défini, démarrer le flux de vérification
if (!AvsGoCamHosted.isAlreadyGoCamVerified()) {

	// appliquer le flou jusqu’à réception d’un événement de succès
	applyBlur();

	// écouter un événement de succès
	AvsGoCamHosted.event.on('success', () => {
		removeBlur();
	});

	// écouter un événement d’erreur
	AvsGoCamHosted.event.on('error', (error) => {
		applyBlur();
	});

	// écouter le clic sur le bouton de vérification d’âge
	document.querySelector('#checkAgeButton').addEventListener('click', () => {
		AvsGoCamHosted.showOverlay();
	});

	// initialiser la bibliothèque
	AvsGoCamHosted.start();

}
				

Choisir un mode

Mode	Effort de mise en place	Qui contrôle l’interface / le flou ?	Gestion des cookies	Idéal pour
Automatique	Minimal	Go.cam	Automatique	Le chemin le plus rapide vers la production
Contrôlé	Modéré	Vous	Automatique	UX personnalisée et timing précis

---

Bonnes pratiques

• Placez le script automatique tôt dans le pour éviter le scintillement avant l’application du flou.
• Utilisez les clés de production uniquement sur les domaines de production ; gardez les clés de développement pour les domaines de test / staging.
• En mode contrôlé, assurez-vous que votre logique de flou/déflou est bien implémentée et liée à l’événement success.

---

Référence de l’API JavaScript

Lorsque vous utilisez l’implémentation hébergée, la bibliothèque Go.cam expose plusieurs méthodes pour vous aider à contrôler le flux de vérification par programmation.

Ces méthodes sont disponibles globalement via l’objet AvsGoCamHosted.

start()

Description

Initialise la bibliothèque Hosted. Cette méthode doit être appelée une fois après l’inclusion du script afin de configurer les écouteurs d’événements et la logique interne.

AvsGoCamHosted.start();
				

showOverlay()

Description

Ouvre l’iframe de vérification Go.cam comme une superposition au-dessus de votre site web.

AvsGoCamHosted.showOverlay();
				

hideOverlay()

Description

Ferme la superposition iframe de vérification Go.cam, sans affecter le statut de vérification de l’utilisateur.

AvsGoCamHosted.hideOverlay();
				

forceVerification()

Description

Supprime le cookie local de vérification afin que l’utilisateur doive effectuer la vérification à nouveau. Après l’appel de cette méthode, vous devez recharger la page pour que le changement prenne effet.

AvsGoCamHosted.forceVerification();
window.location.reload();
				

isAlreadyGoCamVerified()

Description

Vérifie si un cookie local de vérification existe, c’est-à-dire si l’utilisateur a déjà été vérifié sur cet appareil.

AvsGoCamHosted.isAlreadyGoCamVerified();
				

Résumé

Méthode	Objectif
start()	Initialise le SDK Hosted (doit être appelé une fois).
showOverlay()	Ouvre la superposition iframe de vérification Go.cam.
hideOverlay()	Ferme la superposition iframe de vérification.
forceVerification()	Supprime le cookie local (nécessite un rechargement de la page) pour forcer une nouvelle vérification.
isAlreadyGoCamVerified()	Retourne true/false selon que l’utilisateur est vérifié ou non.

Référence des événements

La bibliothèque AvsGoCamHosted fournit un ensemble d’événements que vous pouvez écouter afin de réagir aux étapes clés du processus de vérification.

Utilisez la syntaxe suivante pour vous abonner aux événements :

AvsGoCamHosted.event.on('{eventName}', callback);
				

success

Description

Déclenché lorsque le processus de vérification d’âge se termine avec succès.

AvsGoCamHosted.event.on('success', () => {
  // Gérer le succès
});
				

error

Description

Déclenché lorsque le processus de vérification échoue ou qu’une erreur se produit.

AvsGoCamHosted.event.on('error', (error) => {
  // Gérer l’erreur
});
				

ready

Description

Déclenché une fois que le SDK Hosted a été initialisé et est prêt à être utilisé.

AvsGoCamHosted.event.on('ready', () => {
  // Le SDK est prêt
});
				

resourcesLoaded

Description

Déclenché lorsque toutes les ressources nécessaires à la vérification (scripts, modèles, etc.) sont complètement chargées. À ce stade, la superposition est prête à être affichée.

AvsGoCamHosted.event.on('resourcesLoaded', () => {
  // Les ressources sont prêtes
});
				

closed

Description

Déclenché lorsque l’utilisateur ferme la superposition iframe de vérification.

AvsGoCamHosted.event.on('closed', () => {
  // La superposition a été fermée
});
				

Résumé

Nom de l’événement	Déclenché lorsque	Paramètre du callback
success	La vérification se termine avec succès	aucun
error	La vérification échoue ou une erreur se produit	objet contenant les détails de l’erreur, ex. : {code: 123, msg: 'Message d’erreur'}
ready	Le SDK est initialisé et prêt	aucun
resourcesLoaded	Toutes les ressources requises pour la vérification sont chargées	aucun
closed	La superposition de vérification est fermée par l’utilisateur	aucun