Usage and limits

curl --fail-with-body -sS https://api.alura.io/v1/usage \
  -H "Authorization: Bearer $ALURA_API_KEY"

interface Usage {
  plan: string;
  credits: { allowance: number; used: number; remaining: number };
  daily: { limit: number; used: number; resets_at: string } | null;
  rate_limit: { requests_per_minute: number };
  period: { end: string };
}

const res = await fetch('https://api.alura.io/v1/usage', { headers: { Authorization: `Bearer ${process.env.ALURA_API_KEY}` } });
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const usage = (await res.json()) as Usage;

console.log(`${usage.plan}: ${usage.credits.used} of ${usage.credits.allowance} API credits used, ${usage.credits.remaining} left until ${usage.period.end}`);
console.log(usage.daily ? `today: ${usage.daily.used} of ${usage.daily.limit}` : 'no daily ceiling');
console.log(`rate limit: ${usage.rate_limit.requests_per_minute} requests a minute`);
// Every response also says what it cost and what is left.
console.log(`this call: cost ${res.headers.get('Alura-Credits-Cost')}, remaining ${res.headers.get('Alura-Credits-Remaining')}`);

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://api.alura.io/v1/usage",
    headers={"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}"},
)
with urllib.request.urlopen(request) as response:
    usage = json.load(response)
    headers = response.headers

credits = usage["credits"]
print(f"{usage['plan']}: {credits['used']} of {credits['allowance']} API credits used, {credits['remaining']} left until {usage['period']['end']}")
daily = usage["daily"]
print(f"today: {daily['used']} of {daily['limit']}" if daily else "no daily ceiling")
print(f"rate limit: {usage['rate_limit']['requests_per_minute']} requests a minute")
# Every response also says what it cost and what is left.
print(f"this call: cost {headers['Alura-Credits-Cost']}, remaining {headers['Alura-Credits-Remaining']}")