Étape 3 – Gestion des droits utilisateurs avec l’API Usage

Dans un service commercialisé par abonnement, la gestion des droits des utilisateurs est liée au cycle de vie des abonnements, ce qui signifie qu’il faut constamment mettre à jour ces droits lorsque qu’un abonnement est créé, résilié, suspendu, redémarré, lors d’un changement d’offre ou lorsqu’un abonnement est modifié.

Oubliez tout ça : l’API Usage le fait pour vous.

Elle est conçue pour éviter des tonnes de code inutile en vous indiquant les droits d’un client à l’instant T.

Scalable et normalisée, cette API permet d’intégrer ProAbono dans votre application Web durablement et sans maintenance, même si vos offres commerciales évoluent en permanence.

Cerise sur le gâteau: cette API permet également d’ajuster les métriques et options de vos clients, ce qui simplifie drastiquement la facturation à l’usage.

Pré-requis

Vous devez être familier avec la notion de Caractéristique (Feature).

Récupérer les Usages

GET https://api-42.proabono.com/v1/Usages?ReferenceCustomer=cust-42
{
  "Page": 1,
  "SizePage": 10,
  "Count": 3,
  "TotalItems": 3,
  "Items": [
    {
      "IdSubscription": 462457,
      "ReferenceSegment": "demo-eur",
      "ReferenceFeature": "users",
      "ReferenceCustomer": "cust-42",
      "TypeFeature": "Limitation",
      "QuantityIncluded": 1,
      "QuantityCurrent": 5,
      "DatePeriodStart": "2025-06-07T23:54:20.00Z",
      "DatePeriodEnd": "2025-07-07T23:54:20.00Z"
    },
    {
      "IdSubscription": 462457,
      "ReferenceSegment": "demo-eur",
      "ReferenceFeature": "support-24",
      "ReferenceCustomer": "cust-42",
      "TypeFeature": "OnOff",
      "IsIncluded": false,
      "IsEnabled": true,
      "DatePeriodStart": "2025-06-07T23:54:20.00Z",
      "DatePeriodEnd": "2025-07-07T23:54:20.00Z"
    },
    ...

Plus d’informations et de paramètres supplémentaires dans la documentation API.

Quand les utiliser

Comme recommandé dans la documentation, vous devez récupérer les usages lorsque l’utilisateur se connecte ou lorsqu’il termine un Parcours Client, et stocker ces informations la durée de la session.