API
Authentification, filtres et exemples serveur.
Clés
Créez les clés depuis Configuration → Général. Une clé de lecture permet les rapports ; une clé d'écriture permet aussi l'ingestion. Les clés sont affichées une fois, stockées hachées et révocables. Elles ne sont pas la clé publique du tracker.
Lire un rapport
curl 'https://analytics.votre-domaine.com/v1/analytics?days=30&granularity=day' \
-H "Authorization: Bearer $LUNETRIC_READ_KEY"Les filtres sont days (1, 7, 30, 90), from, to (dates ISO), source, campaign, country, path, currency et granularity (hour, day, week, month). La date to est exclusive. La période maximale est 366 jours ; la vue horaire est limitée à 31 jours.
Les revenus sont en unités mineures et dans la devise sélectionnée. Les outils MCP utilisent les mêmes filtres.
Écrire côté serveur
| Route | Utilisation |
|---|---|
POST /v1/identify | Relier un visiteur à un client |
POST /v1/payments | Enregistrer un paiement confirmé |
POST /v1/refunds | Enregistrer un remboursement explicite |
POST /v1/bot-requests | Enregistrer une exploration |
Envoyez Content-Type: application/json et Authorization: Bearer VOTRE_CLE_ECRITURE. Les requêtes invalides sont rejetées ; les erreurs ne sont pas des confirmations d'intégration.
Remboursement
{
"refund_id": "refund_001",
"transaction_id": "order_001",
"amount_minor": 1200
}provider et provider_account doivent correspondre au paiement si vous les avez personnalisés. Le total remboursé ne peut pas dépasser le paiement.
Exploration
{
"id": "request_unique_001",
"url": "https://votre-site.com/pricing",
"user_agent": "ChatGPT-User/1.0",
"status": 200,
"method": "GET"
}Le middleware fourni évite de devoir gérer vous-même la classification et les nouvelles tentatives. Les doublons utilisent des références stables.