Aller au contenu
Organisation et réglages/Lire la version des règles de calcul

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èreValeur
AdresseGET /api/v1/rules/version
Par son nomPOST /api/v1/tools/get_rules_version, la réponse sous data
Nom de l'outilget_rules_version
Droit demandéLire les totaux (vue CEO, vue groupe, payback) (aggregates.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, VP Sales, Responsable de programme, DAF, CEO, Lecteur / auditeur
Par MCPOui, 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.