NAMES LEGAL pour les développeurs#
Développez des intégrations avec NAMES LEGAL depuis votre propre application : lisez et écrivez le contenu d'un site, vendez NAMES LEGAL à vos utilisateurs sans qu'ils quittent votre produit, et gardez leur site rempli avec les données que vous détenez déjà.
Trois façons de s'intégrer#
| Vous voulez… | Utilisez | Qui le configure |
|---|---|---|
| Lire ou écrire le contenu d'un site (équipe, services, actualités…) depuis du code | API du site | Le propriétaire du site crée une clé API dans sa console |
| Permettre à vos utilisateurs d'acheter un site NAMES LEGAL depuis votre application | Achat intégré | NAMES LEGAL crée un canal de vente pour vous ; vous collez une ligne |
| Remplir et mettre à jour un site à partir de vos propres données (tableur ou API) | Connecteur de données | Le propriétaire du site connecte votre API dans sa console ; vous exposez un flux |
Les trois peuvent se combiner. Une intégration plateforme typique ressemble à ceci :
- Votre utilisateur clique sur Créer mon site dans votre application : le cadre d'achat intégré s'ouvre, il choisit une formule et paie.
- Une fois le site prêt, votre serveur reçoit un webhook
site.readysigné avec l'adresse du site et votre propre référence pour cet utilisateur. - Le propriétaire du site connecte votre application comme source de données dans sa console. Si votre API suit le format de flux NAMES LEGAL, chaque collection est liée automatiquement : les enseignants deviennent l'équipe, les cours deviennent des services, les actualités deviennent des articles de blog.
- À partir de là, le site se met à jour tout seul — toutes les heures, tous les jours, ou instantanément lorsque vous appelez son adresse de webhook.
Points clés#
- Chaque site est indépendant. Chaque site NAMES LEGAL a sa propre adresse (
https://<site>.names.legalou son propre domaine), ses propres données et ses propres clés API. Il n'existe pas d'API globale qui atteindrait tous les sites. - La facturation reste chez NAMES LEGAL. Un utilisateur qui achète depuis votre application devient un client NAMES LEGAL, facturé par NAMES LEGAL. Vous ne gérez jamais les paiements ni les données de carte.
- Marque blanche par conception. Les visiteurs d'un site ne voient jamais de marque NAMES LEGAL provenant de ces intégrations.
- Six langues. La plateforme, le cadre d'achat et le modèle de contenu prennent en charge l'anglais, le français, l'allemand, l'italien, l'espagnol et le portugais.
Conventions utilisées dans cette documentation#
<site>est l'adresse d'un site NAMES LEGAL, par exemplehttps://ecolehorizon.names.legal.- Les dates suivent la norme ISO 8601 :
2026-09-24ou2026-09-24T14:02:11+02:00. - Toutes les requêtes et réponses utilisent du JSON en UTF-8, sauf mention contraire.