Lire le fil de l'euro
Donne le fil de l'euro d'un budget à un jour donné : de l'euro dépensé au revenu signé, sur les mêmes mois.
Dépensé, leads, SQO, deals gagnés, signé, CAC et signé par euro, au total et par canal. Les leads et les SQO demandent aussi le droit de lire le funnel. Les deals gagnés par canal demandent celui de lire le rendement par canal.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/tools/get_euro_thread |
| Réponse | Sous data. |
| Nom de l'outil | get_euro_thread |
| Droit demandé | Lire le détail par canal, fournisseur et contrat (spendDetail.read) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, DAF, Lecteur / auditeur |
| Par MCP | Oui, en lecture. |
Paramètres
Les paramètres sont dans le corps de la requête, en JSON.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
budgetId | oui | texte, non vide | Le budget. list_budgets donne les identifiants. |
asOf | oui | date, AAAA-MM-JJ | Le jour de lecture. En général, aujourd'hui. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/tools/get_euro_thread" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"budgetId": "BUDGET_ID",
"asOf": "2026-11-12"
}Réponse
Ce que l'écran affiche au membre de la clé : chaque valeur avec son statut, une valeur indisponible à null, et ce qui lui est masqué dit avec sa raison.
Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.