Authentification
Toutes les requêtes sortantes utilisent une clé d’API au format MYCENTRAE_SK_…. Vous la retrouvez dans Sites & Sonde du CRM.
Deux modes d’envoi sont acceptés :
// 1. Header HTTP (recommandé) Authorization: Bearer MYCENTRAE_SK_xxxxxxxx // 2. Query string ?key=MYCENTRAE_SK_xxxxxxxx
Sonde MyCentrae
À placer avant </body>. Léger et asynchrone.
<script async src="https://www.mycentrae.fr/static/mycentrae-probe.js" data-mycentrae-key="MYCENTRAE_SK_xxxxxxxx" data-mycentrae-endpoint="https://www.mycentrae.fr/api/connect"></script>
La sonde gère : parcours, formulaires, pageviews conformes RGPD, commandes injectées.
Capture de leads
Endpoint principal :
POST
/api/connect| Champ | Type | Description |
|---|---|---|
email | string | Identifiant contact (requis). |
site_url | string | Origine du site. |
first_name | string | Optionnel. |
last_name | string | Optionnel. |
phone | string | Optionnel. |
source_form | string | ID ou nom de formulaire. |
curl -X POST https://www.mycentrae.fr/api/connect \ -H "Authorization: Bearer MYCENTRAE_SK_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"email":"alice@exemple.fr","site_url":"https://exemple.fr","source_form":"contact"}'
Commandes injectées
GET
/api/probe/commands?key=…&site_url=…Réponses : tableau JSON de commandes (widget, bannière, redirect…).
POST
/api/probe/commands/ackAnalytics
POST
/api/analytics/collectPayload pageview envoyé automatiquement par la sonde, agrégé dans le module Analytics.
Blog & sitemaps
GET
/{slug}/sitemap.xmlChaque blog public expose ses URLs pour une indexation propre.
Erreurs & retries
| Code | Cas | Conduite |
|---|---|---|
200 | OK | — |
401 | Clé invalide | Vérifier Bearer ou query. |
404 | Site absent | Reconnecter dans le CRM. |
503 | Boot DB | Réessayer après 1 s. |