Chargement...
Chargement...
Spécification OpenAPI 3.1 publique — endpoints, schémas, exemples.
Chaque requête doit inclure votre clé API. Deux en-têtes acceptés :
# 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}'Vos clés API se gèrent depuis /profil/api (création, révocation, suivi d'usage 30 jours).
Cette clé publique permet d’essayer les endpoints accessibles au niveau Free. Son quota est partagé entre tous ses utilisateurs sur une même instance : 10 requêtes par minute et 200 par fenêtre de 24 heures.
tvx_sandbox_public_demo_key_read_onlySandboxLa disponibilité dépend du quota restant et du service. Cette clé ne permet ni les exports de facturation ni l’import PMS. Pour un usage individuel, créez une clé depuis /profil/api ; aucune capacité mensuelle distincte n’est garantie.
Deux endpoints IA accessibles avec votre clé API tevaxia (rate-limit tier standard) :
# 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 }Le serveur essaie les fournisseurs gratuits dans l'ordre : Google Gemini 3.6 Flash, puis Groq et Cerebras si leurs clés sont configurées — il bascule automatiquement au suivant en cas d'échec. Si vous avez configuré une clé BYOK dans votre profil, elle est utilisée en priorité. Limite : rate-limit tier de votre clé API (Free : 10/min, 200/jour).
L’estimation unitaire et les lots utilisent le même contrat : appartements en pleine propriété, paramètres facultatifs et valeurs par défaut documentés dans OpenAPI. Les exemples utilisent des hypothèses explicites, à adapter au bien. Les champs inconnus, booléens textuels et clés d’ajustement non reconnues sont refusés. Un lot peut réussir partiellement : vérifiez chaque résultat. La méthode utilise une référence communale et des ajustements non validés statistiquement, sans certification TEGOVA ou CRR.
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`);