REST API
GET /api/meFür Entwickler
Profil, Plan und aktuelle Nutzung — nützlich, um vor einem Request das Rest-Kontingent zu prüfen.
Request
GET https://api.bodenrichtwert.ai/api/me
Authorization: Bearer brw_pat_...
Keine Query-Parameter. Identifikation läuft über den Bearer Token.
Response (200 OK)
{
"id": "a3c9…",
"plan": "free",
"effective_plan": "pro",
"usage_this_month": 14,
"limit": 100,
"trial_expires_at": "2026-07-21T12:00:00Z",
"trial_usage": 14,
"trial_limit": 100,
"trial_active": true
}
Felder
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Deine User-ID |
plan | "free" | "starter" | "pro" | "enterprise" | Dein gebuchter Plan |
effective_plan | wie plan | Effektiv wirksamer Plan — "pro" während des 14-Tage-Trials, sonst = plan |
usage_this_month | integer | Anzahl Requests im laufenden Abrechnungsmonat |
limit | integer | null | Effektiver harter Cap dieses Monats — 100 im Trial, 0 auf Free (Paywall), 50 auf Starter, 500 auf Pro, null auf Enterprise (vertraglich unbegrenzt). Anfragen jenseits des Caps werden mit 402 abgelehnt. |
trial_expires_at | string | null | ISO-8601, wann der 14-Tage-Trial endet, oder null |
trial_usage | integer | Bisher im Trial-Fenster genutzte Requests |
trial_limit | integer | Trial-Cap (aktuell 100) |
trial_active | boolean | true, solange der Trial läuft und nicht ausgeschöpft ist |
Fehler
| Status | Code | Bedeutung |
|---|---|---|
401 | missing_token | Authorization: Bearer <token>-Header fehlt |
401 | invalid_token | Token ungültig oder abgelaufen |
Wann nutzen?
- Vor Bulk-Jobs — prüfen, wie viel Kontingent noch frei ist.
- UI anzeigen — Usage-Fortschritt im eigenen Dashboard.
- Trial-Logik — via
trial_activeerkennen, ob der Nutzer in der kostenlosen Testphase ist.