Zum Inhalt

Abonnementverlauf abrufen.

Methode

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

Beschreibung

Gibt historische Nutzungsdaten für die Abonnements der Organisation im angeforderten Zeitraum zurück. Wenn sich die lizenzierte Menge in diesem Zeitraum ändert, enthält die Antwort mehrere Datensätze für dasselbe Abonnement.

Die Antwort enthält nur nachschüssig abgerechnete Abonnements.

Pfadparameter
org_id string erforderlich

ID der Organisation, deren Abonnementverlauf abgerufen wird.

Abfrageparameter
start date-time

Beginn des Berichtszeitraums im Format RFC 3339. Der Zeitraum muss 1 bis 40 Tage umfassen.
end date-time

Ende des Berichtszeitraums im Format RFC 3339. Der Zeitpunkt muss mindestens eine Stunde zurückliegen.

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

Schema der erfolgreichen Antwort (200)
object

SubscriptionHistoryResult enthält die Antwort auf eine Anforderung zum Abonnementverlauf.
items array of objects
object

SubscriptionHistoryItem beschreibt einen Zeitraum mit gleichbleibender Anzahl lizenzierter Einheiten einer Abonnementposition.
sub_id string

ID des Abonnements.
tenant_id string

ID des Mandanten, dem das Abonnement zugewiesen ist.
start date-time

Beginn des Zeitraums im Format RFC 3339.
end date-time

Ende des Zeitraums im Format RFC 3339.
kind string

Art der Abonnementposition (beispielsweise Ressource, Speicher, Knoten, virtueller Computer oder Datenbank).
qty int64

Anzahl lizenzierter Einheiten für diese Art von Abonnementposition (beispielsweise 10 Ressourcen oder 5 zusätzliche Speicherlizenzen mit einem Kontingent von jeweils 100 GB).
amount int64

Gesamtbetrag in Cent, der für diese Position im betreffenden Zeitraum berechnet wurde. Der Betrag kann sich ändern, wenn der Tarif im laufenden Abrechnungszeitraum vor der Rechnungserstellung geändert wird.

Antwortbeispiel
{
  "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"
    }
  ]
}