Obtenir l’historique des abonnements.¶

Méthode¶

GET https://papi.afi.ai/api/v1/orgs/{org_id}/licensing/subscriptions/history

Description¶

Renvoie l’historique d’utilisation des abonnements de l’organisation pour la période demandée. Si le nombre d’unités sous licence change au cours de cette période, la réponse comprend plusieurs enregistrements pour le même abonnement.

La réponse inclut uniquement les abonnements facturés à terme échu.

Paramètres de chemin¶

org_id string obligatoire

Identifiant de l’organisation.

Paramètres de requête¶

start date-time

Début de la période du rapport, au format RFC 3339. Cette période doit couvrir de 1 à 40 jours.

end date-time

Fin de la période du rapport, au format RFC 3339. Elle doit précéder l’heure actuelle d’au moins une heure.

curl

curl -X GET \
    -H 'Authorization: {api-key}' \
    https://papi.afi.ai/api/v1/orgs/{org_id}/licensing/subscriptions/history

Schéma de la réponse en cas de succès (200)¶

object

SubscriptionHistoryResult contient la réponse à une demande d’historique des abonnements.

items array of objects

object

SubscriptionHistoryItem représente une période pendant laquelle le nombre d’unités sous licence pour un élément d’abonnement reste constant.

sub_id string

Identifiant de l’abonnement.

tenant_id string

Identifiant du locataire auquel l’abonnement est attribué.

start date-time

Début de la période, au format RFC 3339.

end date-time

Fin de la période, au format RFC 3339.

kind string

Type d’élément d’abonnement (par exemple, ressource, stockage, nœud, machine virtuelle ou base de données).

qty int64

Nombre d’unités sous licence pour ce type d’élément (par exemple, 10 ressources ou 5 licences de stockage supplémentaires donnant chacune droit à un quota de 100 Go).

amount int64

Montant total, en centimes, facturé pour cet élément pendant la période correspondante. Ce montant peut changer si le plan tarifaire est modifié en cours de période de facturation, avant l’émission de la facture.

Exemple de réponse¶

{
  "items": [
    {
      "sub_id": "string",
      "tenant_id": "string",
      "start": "2025-11-19T20:02:49.311313Z",
      "end": "2025-11-19T20:02:49.311313Z",
      "kind": "string",
      "qty": "int64-as-string",
      "amount": "int64-as-string"
    }
  ]
}