Beitrag berechnen

Berechne...

Tier-OP-Versicherung
Tier-Krankenversicherung

Authentifizierung

Alle /api/ Endpunkte erfordern einen API-Key im Header:

X-Api-Key: dein-api-key

Ohne Key: 401. Falscher Key: 403.

Rate Limits

API: 60 Requests/Minute pro Key. Preistabelle: 10/Min. Cache-Refresh: 2/Stunde. Bei Ueberschreitung: 429 Too Many Requests mit retry_after_seconds.

Response-Headers

HeaderBeschreibung
X-Request-IdEindeutige Request-ID fuer Debugging
X-Response-Time-MsAntwortzeit in Millisekunden

POST /api/quote

Berechnet Monatsbeitraege fuer alle 6 Tarife einer Rasse.

ParameterTypPflichtBeschreibung
tierartstringNein"Hund" oder "Katze", Default: "Hund"
rassestringJaExakter Rassenname, z.B. "Labrador-Retriever"
geburtsdatumstringJaFormat YYYY-MM-DD, max. 9 Jahre alt
selbstbeteiligungintNein0, 250 oder 500 (EUR), Default: 250

Beispiel:

curl -X POST https://hundekv.outrnk.io/api/quote \ -H "Content-Type: application/json" \ -H "X-Api-Key: dein-key" \ -d '{ "rasse": "Labrador-Retriever", "geburtsdatum": "2023-06-01", "selbstbeteiligung": 250 }'

Response (gekuerzt):

{ "rasse": "Labrador-Retriever", "alter_jahre": 2, "risikoklasse_tkv": "D", "risikoklasse_top": "D", "tarife": [ { "produkt": "Tier-OP-Versicherung", "paket": "Komfort", "monatsbeitrag_brutto": 13.83, "monatsbeitrag_netto": 11.62, "jahresbeitrag_netto": 199.44, "zusatzoptionen": [ { "name": "Tier Assistance", "monatsbeitrag_brutto": 5.95, "monatsbeitrag_netto": 5.00 } ] }, ...5 weitere Tarife ], "quelle": "cache" }

Error Responses

CodeBedeutung
400Ungueltige Parameter (z.B. Tier zu alt, unbekannte Rasse)
401API Key fehlt
403API Key ungueltig
429Rate Limit erreicht
502HanseMerkur API nicht erreichbar
503Cache wird noch geladen (Startup)

GET /api/rassen/{tierart}/{suche}

Sucht Rassen nach Name. Gibt Liste mit Risikoklassen zurueck.

curl https://hundekv.outrnk.io/api/rassen/Hund/Labrador \ -H "X-Api-Key: dein-key" # [{"name":"Labrador","risikoklasse_tkv":"D",...}]

GET /api/preistabelle

Komplette Preistabelle aus dem Cache. Gruppiert nach Risikoklasse, Alter, SB. Rate Limit: 10/Min.

GET /api/usage

Zeigt Nutzungsstatistiken fuer deinen API Key.

curl https://hundekv.outrnk.io/api/usage \ -H "X-Api-Key: dein-key" # {"total_requests":42,"rate_limit":"60/minute",...}

POST /api/refresh-cache

Cache neu laden. Rate Limit: 2/Stunde. Dauert ~2-3 Min im Hintergrund.

GET /health

Service-Status. Kein API-Key noetig.

Tarife & Zusatzoptionen

Jeder Request gibt 6 Tarife zurueck:

  • Tier-OP-Versicherung: Komfort, Premium, PremiumPlus
  • Tier-Krankenversicherung: Komfort, Premium, PremiumPlus

Zusatzoptionen (wenn verfuegbar im jeweiligen Tarif):

ZusatzKomfortPremiumPremiumPlus
Tier AssistanceJaJaJa
Zahn (nur Alter 0-5)-JaJa
Vorsorge--Nur KV

Hinweise

  • Preise kommen aus einem Pre-Cache (sofort, 0ms) oder Live-API (~1-2s bei Cache-Miss)
  • Maximales Alter bei Versicherungsbeginn: 8 Jahre (=Alter 0-8)
  • Zahn-Zusatztarif nur fuer Tiere bis 5 Jahre
  • Einige Rasse/Alter/SB-Kombinationen sind nicht versicherbar (z.B. hohe Risikoklasse + SB 0)
  • 1.499 Rassen im System (1.361 Hund + 138 Katze)

OpenAPI / Swagger

Interaktive API-Dokumentation: /docs (Swagger UI) oder /redoc (ReDoc)