GET /v1/keys/trial/{key} — Trial-Key-Status

Status eines per POST /v1/keys/trial geminteten Keys: Rest-Laufzeit, Requests heute/gesamt, deklarierte Limits. Gedacht für Client-UIs, die dem Nutzer „deine Lizenz: noch 5 Tage” zeigen wollen.

curl https://api.lodapi.de/v1/keys/trial/lod_td8j5b86m6s32ujqbdmf8wwah5sv99xd

Response (200):

{
  "key_prefix": "lod_td8j5b86",
  "tier": "trial",
  "status": "active",
  "created_at": "2026-07-07T10:12:01Z",
  "expires_at": "2026-07-14T10:12:01Z",
  "seconds_remaining": 604784,
  "requests_today": 1,
  "requests_total": 1,
  "limits": { "requests_per_minute": 60, "requests_per_day": 5000 }
}

• status: active | expired | revoked. Auch abgelaufene/revozierte Keys antworten mit 200 + Status (die UI soll „abgelaufen” anzeigen können); nur unbekannte oder malformte Keys geben 404.
• Privacy: Der Klartext-Key steht im Pfad, wird aber im Usage-Log als /v1/keys/trial/{key} redigiert und nirgends persistiert.
• Zählung: requests_today zählt ab Mitternacht UTC (date_trunc('day')), requests_total über die Key-Lebenszeit — beides aus api_key_usage.