Lire un canal d'un budget
Donne un canal d'un budget, comme l'écran de pilotage le lit à un jour donné.
Son budget, son dépensé jusqu'au dernier mois arrêté, ce que ses contrats engagent encore, son reste et sa fin d'année prévue, chacun avec son statut.
Appel
| Repère | Valeur |
|---|---|
| Adresse | GET /api/v1/budgets/:budgetId/channels/:channelKey |
| Par son nom | POST /api/v1/tools/get_channel, la réponse sous data |
| Nom de l'outil | get_channel |
| 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
budgetId et channelKey sont dans l'adresse. Les autres suivent l'adresse, après ?.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
budgetId | oui | texte, non vide | Le budget. list_budgets donne les identifiants. |
channelKey | oui | texte, non vide | Le canal : une clé du catalogue (paid_media, events, content…). |
asOf | oui | date, AAAA-MM-JJ | Le jour de lecture. En général, aujourd'hui. |
Exemple
curl "$MARVESTO_URL/api/v1/budgets/BUDGET_ID/channels/paid_media?asOf=2026-11-12" \
-H "x-api-key: $MARVESTO_API_KEY"Réponse
channelKey, throughPeriod (le dernier mois arrêté lu), puis budget, actual (dépensé), committed (engagé), available (reste) et landing (fin d'année prévue).
Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.