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 sur la période demandée. Si la quantité sous licence change au cours de cette période, la réponse comprend plusieurs enregistrements pour le même abonnement.

Seuls les abonnements postpayés sont inclus dans la réponse.

Paramètres de chemin¶

org_id string obligatoire

Identifiant de l’organisation pour laquelle obtenir l’historique des abonnements.

Paramètres de requête¶

start date-time

Début de la fenêtre de rapport. Utilisez le format RFC 3339. La fenêtre doit couvrir de 1 à 40 jours.

end date-time

Fin de la fenêtre de rapport. Utilisez le format RFC 3339. 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 réussie (200)¶

object

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

items array of objects

object

SubscriptionHistoryItem représente un intervalle de temps pendant lequel la quantité sous licence de l’élément d’abonnement reste constante.

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. Utilisez le format RFC 3339.

end date-time

Fin de la période. Utilisez le 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 accordant chacune un quota de 100 Go).

amount int64

Montant total, en centimes, facturé pour cet élément pendant l’intervalle correspondant. Ce montant peut changer si le plan tarifaire est modifié au cours de la 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"
    }
  ]
}