Nutzung

GET https://api.kennmarq.com/v1/usage

Die Markierungen, zurückgesendeten Daten und Zeitstempel dieses Monats für die Umgebung des Schlüssels, mit den Limits Ihres Plans. Funktioniert mit jedem gültigen Schlüssel: Ein Testschlüssel sieht das Testkontingent.

curl

curl https://api.kennmarq.com/v1/usage -H "Authorization: Bearer $KENNMARQ_API_KEY"

200 application/json

{
  "object": "usage",
  "plan": "free",
  "environment": "live",
  "period": {
    "id": "2026-10",
    "start": "2026-10-01T00:00:00.000Z",
    "end": "2026-11-01T00:00:00.000Z"
  },
  "marks": { "used": 412, "limit": 1000, "ceiling": 1000 },
  "data_out": { "bytes": 389214772, "limit_bytes": 1000000000 },
  "time_stamps": { "used": 0, "limit": 1000 },
  "rate_limit": { "calls_per_minute": 10 }
}

Felder des Usage-Objekts
Feld	Bedeutung
`plan`	Der Plan Ihrer Organisation: free, indie, startup, scale oder enterprise.
`environment`	Die Umgebung des Schlüssels: live oder test. Jede hat eigene Kontingente.
`period`	Der gezählte Kalendermonat, in UTC. Mit seinem Ende beginnt die Zählung von vorn.
`marks`	Die in diesem Monat erstellten Markierungen, das Monatskontingent (limit) und wie weit sie gehen dürfen (ceiling): das Kontingent oder, bei einem monatlichen kostenpflichtigen Plan, der die Zusatzmengen abrechnet, das Zehnfache davon.
`data_out`	Die Bytes der in diesem Monat zurückgesendeten markierten Dateien und das Kontingent (1 GB = 10⁹ Byte).
`time_stamps`	Die Zeitstempel von POST /v1/tsa in diesem Monat und ihr Kontingent.
`rate_limit`	Die Aufrufe pro Minute, die jeder Schlüssel in Ihrem Plan machen darf.

Abfragen der Nutzung zählen zu den Aufrufen pro Minute des Schlüssels, aber nie gegen Ihre Markierungen.