Zum Inhalt

Abonnementverlauf abrufen.

Methode

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

Beschreibung

Gibt die historische Nutzung der Abonnements einer Organisation für den 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 nachträglich abgerechnete Abonnements.

Pfadparameter
org_id string erforderlich

ID der Organisation, deren Abonnementverlauf abgerufen werden soll.

Abfrageparameter
start date-time

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

Ende des Berichtszeitraums im RFC-3339-Format. Der Zeitpunkt muss mindestens eine Stunde vor der aktuellen Zeit liegen.

 
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 ist die Antwort auf eine Anfrage zum Abonnementverlauf.
items array of objects
object

SubscriptionHistoryItem stellt einen Zeitraum dar, in dem die Menge der lizenzierten Abonnementposition konstant bleibt.
sub_id string

ID des Abonnements.
tenant_id string

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

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

Ende des Zeitraums im RFC-3339-Format.
kind string

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

Anzahl lizenzierter Einheiten für die Positionsart (beispielsweise 10 Ressourcen oder 5 zusätzliche Speicherlizenzen mit jeweils 100 GB Kontingent).
amount int64

Gesamtbetrag in Cent, der für diese Position im entsprechenden Intervall berechnet wurde. Dieser Betrag kann sich ändern, wenn der Tarif mitten im 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"
    }
  ]
}