Lire la version des règles de calcul
Donne la version des règles de calcul avec laquelle les chiffres sont lus, et la date de son dernier changement.
Chaque changement d'une règle (seuils, attribution, revenu, objectifs par canal…) ajoute une version, et les chiffres sont recalculés avec les règles en vigueur sur tout l'historique. Gardez la version avec ce que vous lisez : deux lectures faites sous deux versions ne se comparent pas sans regarder ce qui a changé.
Appel
| Repère | Valeur |
|---|---|
| Adresse | GET /api/v1/rules/version |
| Par son nom | POST /api/v1/tools/get_rules_version, la réponse sous data |
| Nom de l'outil | get_rules_version |
| Droit demandé | Lire les totaux (vue CEO, vue groupe, payback) (aggregates.read) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, VP Sales, Responsable de programme, DAF, CEO, Lecteur / auditeur |
| Par MCP | Oui, en lecture. |
Paramètres
Aucun paramètre.
Exemple
curl "$MARVESTO_URL/api/v1/rules/version" \
-H "x-api-key: $MARVESTO_API_KEY"Réponse
version (un nombre entier) et changedAt (l'instant du dernier changement, en millisecondes, ou null).
{
"version": 14,
"changedAt": 1794268800000
}Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.