/api/v1/projects/{ref}/metrics/dataEnvoyer des chiffres
Envoie les valeurs des indicateurs d'un projet. La page Résultats du portail client les affiche dans les 30 secondes.
Envoie des chiffres dans la page Résultats du portail client : dépenses publicitaires, contacts obtenus, visites depuis Google… Le client les voit dans les 30 secondes, sans recharger la page.
C'est la route à appeler depuis Make, Zapier ou n8n, ou depuis un script qui
lit vos comptes publicitaires. Avec Claude, l'outil MCP push_metrics fait la
même chose.
- Un point par jour et par indicateur. Renvoyer une journée remplace sa valeur : une synchronisation peut se rejouer sans créer de doublon.
- Un indicateur inconnu est créé, nommé d'après sa clé. Donnez-lui ensuite
un libellé et une explication pour le client avec
Définir des indicateurs, ou depuis l'onglet
Résultats du projet. Passez
create_missing_metrics: falsepour refuser les clés inconnues. - Un ratio ne reçoit pas de points : il se calcule à partir des indicateurs qu'il divise.
Paramètres de chemin
| Paramètre | Description |
|---|---|
ref | L'id ou le slug du projet |
Corps de la requête
| Champ | Type | Requis | Contraintes |
|---|---|---|---|
points | array | oui | 1 à 10 000 points |
points[].metric | string | oui | La key de l'indicateur (spend, leads…) |
points[].date | string | oui | Le jour, au format YYYY-MM-DD |
points[].value | number | oui | La valeur de ce jour |
create_missing_metrics | boolean | true par défaut |
Cette route accepte un en-tête Idempotency-Key.
Exemple
curl -X POST "https://www.tetikasa.app/api/v1/projects/campagne-meta-raphael/metrics/data" \
-H "Authorization: Bearer $TETIKASA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"points":[
{"metric":"spend","date":"2026-10-28","value":142.5},
{"metric":"leads","date":"2026-10-28","value":9}
]}'Erreurs
code | Statut | Quand |
|---|---|---|
invalid_request | 422 | Corps invalide, date mal formée, indicateur inconnu (avec create_missing_metrics: false) ou ratio |
forbidden | 403 | Le reporting est inclus dans les plans payants |
not_found | 404 | Projet inexistant ou d'une autre organisation |
unauthorized | 401 | Clé absente, invalide, révoquée ou expirée |
Documentation liée
- GET
Lire les résultats
Les indicateurs d'un projet avec leur valeur sur une période, celle de la période précédente et la variation.
- POST
Définir des indicateurs
Crée ou met à jour les indicateurs d'un projet : leur libellé et leur explication pour le client, leur unité, leur calcul.
- POST
Préparer un rapport
Prépare le rapport d'une période avec le mot de l'agence ; il peut être publié et envoyé au client par mail.