Chargement...
Chargement...
Öffentliche OpenAPI 3.1-Spezifikation — Endpoints, Schemas, Beispiele.
Jede Anfrage muss Ihren API-Schlüssel enthalten. Zwei akzeptierte Header:
# Option 1 — X-API-Key header
curl https://www.tevaxia.lu/api/v1/estimation \
-H "X-API-Key: tvx_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"commune":"Luxembourg","surface":90}'
# Option 2 — Authorization Bearer
curl https://www.tevaxia.lu/api/v1/estimation \
-H "Authorization: Bearer tvx_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"commune":"Luxembourg","surface":90}'Ihre API-Schlüssel verwalten Sie unter /profil/api (Erstellung, Widerruf, 30-Tage-Nutzungsverfolgung).
Mit diesem öffentlichen Schlüssel können Sie Endpunkte des Free-Tarifs testen. Alle Nutzer derselben Serverinstanz teilen das Kontingent: 10 Anfragen pro Minute und 200 je 24-Stunden-Fenster.
tvx_sandbox_public_demo_key_read_onlySandboxDie Verfügbarkeit hängt vom verbleibenden Kontingent und vom Dienst ab. Dieser Schlüssel erlaubt weder Rechnungsexporte noch PMS-Importe. Erstellen Sie für die individuelle Nutzung einen Schlüssel unter /profil/api; eine zusätzliche monatliche Kapazität wird nicht garantiert.
Zwei KI-Endpoints mit Ihrem tevaxia API-Schlüssel zugänglich (Standard-Rate-Limit):
# POST /api/v1/ai/analyze
curl https://www.tevaxia.lu/api/v1/ai/analyze \
-H "X-API-Key: tvx_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"context": "Commune: Luxembourg\nSurface: 90m²\nEstimation: 950000 EUR",
"prompt": "Comment this estimate vs market."
}'
# → { "text": "...", "model": "gemini-3.6-flash", "provider": "gemini", "remaining": -1 }
# POST /api/v1/ai/chat
curl https://www.tevaxia.lu/api/v1/ai/chat \
-H "X-API-Key: tvx_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"messages": [
{ "role": "user", "content": "How is LU 3% VAT computed?" }
]
}'
# → { "text": "...", "model": "...", "provider": "...", "remaining": -1 }Der Server versucht die kostenlosen Anbieter der Reihe nach: Google Gemini 3.6 Flash, dann Groq und Cerebras, sofern deren Schlüssel konfiguriert sind — bei einem Fehler wird automatisch der nächste verwendet. Wenn Sie einen BYOK-Schlüssel in Ihrem Profil konfiguriert haben, hat dieser Vorrang. Limit: Rate-Limit-Stufe Ihres API-Schlüssels (Free: 10/Min, 200/Tag).
Einzel- und Stapelschätzungen verwenden denselben Vertrag: Eigentumswohnungen, optionale Parameter und in OpenAPI dokumentierte Standardwerte. Die Beispiele nutzen ausdrückliche, an das Objekt anzupassende Annahmen. Unbekannte Felder, Boolesche Werte als Text und unbekannte Anpassungsschlüssel werden abgelehnt. Ein Stapel kann teilweise erfolgreich sein: Prüfen Sie jedes Ergebnis. Die Methode verwendet eine Gemeindereferenz und statistisch nicht validierte Anpassungen, ohne TEGOVA- oder CRR-Zertifizierung.
const response = await fetch(
"https://www.tevaxia.lu/api/v1/estimation/batch",
{
method: "POST",
headers: {
"X-API-Key": process.env.TEVAXIA_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
items: myPortfolio.map((asset) => ({
commune: asset.commune,
surface: asset.surface,
typeBien: "appartement",
estNeuf: false,
parking: false,
nbChambres: 0,
classeEnergie: "D",
etage: "adjEtage2e3eRef",
etat: "adjEtatBonRef",
exterieur: "adjExtBalconRef",
})),
}),
}
);
if (!response.ok) throw new Error(await response.text());
const { results, succeeded, failed } = await response.json();
console.log(`${succeeded}/${results.length} assets estimated`);