Aller au contenu
Lire les chiffres/Lire les recommandations de pilotage

Lire les recommandations de pilotage

Donne les recommandations de pilotage d'un budget à un jour donné.

Transferts, enveloppes, échéances de préavis, tests sur le pipeline et sur la qualité : chacune avec ses faits, ses hypothèses et son montant. Aucune n'est exécutée par le produit : une personne décide à l'écran.

Appel

RepèreValeur
AdressePOST /api/v1/tools/get_recommendations
RéponseSous data.
Nom de l'outilget_recommendations
Droit demandéLire le détail par canal, fournisseur et contrat (spendDetail.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, DAF, Lecteur / auditeur
Par MCPOui, en lecture.

Paramètres

Les paramètres sont dans le corps de la requête, en JSON.

ParamètreRequisType et limitesÀ quoi il sert
budgetIdouitexte, non videLe budget. list_budgets donne les identifiants.
asOfouidate, AAAA-MM-JJLe jour de lecture. En général, aujourd'hui.

Exemple

curl -X POST "$MARVESTO_URL/api/v1/tools/get_recommendations" \
  -H "x-api-key: $MARVESTO_API_KEY" \
  -H "content-type: application/json" \
  -d @corps.json

Le 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.