Aller au contenu
ProAbonoProAbonoProAbono Docs

Mettre à jour les usages

Contexte

Section titled “Contexte”

Dans de nombreux cas, vos clients auront souscrit à une offre avec la possibilité d’activer des options, utiliser un certain de nombre de ressources, etc. Par exemple, votre client dispose d’un abonnement qui contient 3 licences pour l’utilisation d’un logiciel. Mais, il peut à tout moment ajouter une licence supplémentaire.

Dans ce cas, vous devez notifier ProAbono, pour que les éventuelles modifications de tarifs soient appliquées.

Prérequis

Section titled “Prérequis”

Pour que cela fonctionne, vous devez avoir :

  • Au moins un client avec un abonnement actif.
  • L’abonnement du client doit contenir au moins une caractéristique modifiable.

Procédure

Section titled “Procédure”

1. lister les caractéristiques de l’abonnement

Section titled “1. lister les caractéristiques de l’abonnement”

Requête

POST https://api-42.proabono.com/v1/Usage?ReferenceCustomer={ReferenceCustomer}
{
  "ReferenceCustomer": "cust-42",
  "DateStamp": "2026-08-01T15:31:00.00Z"
}

ProAbono va lister toutes les caractéristiques liées à l’abonnement du client et décrire 2 quantités :

  • quantité incluse de cette caractéristique dans l’abonnement
  • quantité actuelle de cette caractéristique

2. Modifier la quantité ou l’activation d’une caractéristique

Section titled “2. Modifier la quantité ou l’activation d’une caractéristique”

Exemple de requête pour une caractéristique avec quantité : Limitation ou Consumption

POST https://api-42.proabono.com/v1/Usage
{
  "ReferenceFeature": "feat-team-members",
  "ReferenceCustomer": "cust-42",
  "Increment": 5,
  "DateStamp": "2026-08-01T15:31:00.00Z"
}

OU

Exemple de requête pour une caractéristique avec activation : OnOff

POST https://api-42.proabono.com/v1/Usage
{
  "ReferenceFeature": "feat-support-24",
  "ReferenceCustomer": "cust-42",
  "IsEnabled": true,
  "DateStamp": "2026-08-01T15:31:00.00Z"
}