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ère | Valeur |
|---|---|
| Adresse | POST /api/v1/tools/get_recommendations |
| Réponse | Sous data. |
| Nom de l'outil | get_recommendations |
| 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_recommendations" \
-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.