Utilizzo

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

Le marcature, i dati restituiti e le marche temporali di questo mese per l’ambiente della chiave, con i limiti del tuo piano. Funziona con qualsiasi chiave valida: una chiave di test vede la quota di test.

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 }
}

Campi dell’oggetto usage
Campo	Significato
`plan`	Il piano della tua organizzazione: free, indie, startup, scale o enterprise.
`environment`	L’ambiente della chiave: live o test. Ciascuno ha le proprie quote.
`period`	Il mese di calendario conteggiato, in UTC. Alla sua fine i conteggi ripartono da zero.
`marks`	Le marcature fatte questo mese, la quota del mese (limit) e fin dove possono arrivare (ceiling): la quota, o dieci volte tanto con un piano mensile a pagamento, che fattura gli extra.
`data_out`	I byte di file marcati restituiti questo mese, e la quota (1 GB = 10⁹ byte).
`time_stamps`	Le marche temporali da POST /v1/tsa di questo mese, e la loro quota.
`rate_limit`	Le chiamate al minuto che ogni chiave può fare con il tuo piano.

Le chiamate a usage contano tra le chiamate al minuto della chiave, ma mai sulle tue marcature.