Rechercher dans la documentation

Tapez pour filtrer les pages, les guides et les endpoints.

POST/api/v1/projects/{ref}/metrics/data

Envoyer 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: false pour 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ètreDescription
refL'id ou le slug du projet

Corps de la requête

ChampTypeRequisContraintes
pointsarrayoui1 à 10 000 points
points[].metricstringouiLa key de l'indicateur (spend, leads…)
points[].datestringouiLe jour, au format YYYY-MM-DD
points[].valuenumberouiLa valeur de ce jour
create_missing_metricsbooleantrue 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

codeStatutQuand
invalid_request422Corps invalide, date mal formée, indicateur inconnu (avec create_missing_metrics: false) ou ratio
forbidden403Le reporting est inclus dans les plans payants
not_found404Projet inexistant ou d'une autre organisation
unauthorized401Clé absente, invalide, révoquée ou expirée
PrivacyTermsapp icon