API ügynököknek

Ugyanaz a motor, mint a webes kalkulátoron. Nincs API-kulcs, nincs süti, CORS nyitott. Az eredmény tájékoztató, nem jogi tanácsadás.

OpenAPI: /openapi.json · gépeknek: /llms.txt · felfedezés: GET /api

GET

curl "https://kamatai.hu/api/calculate?toke=1250000&kezd=2025-03-15&zar=2026-08-26&felek=b2b"

POST

curl -s https://kamatai.hu/api/calculate \
  -H 'content-type: application/json' \
  -d '{"principal":1250000,"start":"2025-03-15","end":"2026-08-26","party":"b2b"}'

Paraméterek

Mindkét névalak jó, GET query paraméterként és POST JSON mezőként is.

• toke / principal — tőke, kötelező
• kezd / start — késedelem kezdete, YYYY-MM-DD, kötelező
• zar / end — záró nap, alapból ma
• felek / party — b2b vagy person
• mod / rateMode — auto, fix, mnbplus, mnb, mnb2, mnb5, avr98, avr536
• x / customRate — fix % vagy MNB+x
• ptk / regime — new vagy old (2004–2013, vállalkozásnál +7%)
• atalany / recovery — behajtási költségátalány, csak b2b. B2B-nél alapból be, personnál mindig ki
• plafon / rateCap — 25%-os kamatplafon (454/2022. Korm. rendelet), alapból be; kikapcsolás: plafon=0
• penznem / currency — HUF (alap) vagy EUR; EUR-nál az EKB irányadó kamata az alapkamat, az átalány pedig 40 EUR átváltás nélkül

Tömeges számítás, max 50 sor: POST /api/bulk JSON rows tömbbel vagy csv mezővel. Weblap: /tobb (a fájl nem megy szerverre). Hostolt API: 30 kérés / óra / IP.

Részbefizetés (egy adós, N esemény) csak a weben: /reszbefizetes. Nincs szerveroldali ügytárolás.

Válasz

• input — a kérés úgy, ahogy a motor értette (aliasok és alapértelmezések feloldva)
• result.days — a késedelem napjai, mindkét szélső nappal együtt
• result.interest — egész forint, EUR pénznemnél egész euró; interestExact a kerekítetlen érték
• result.recovery és result.recoveryFxRate — az átalány és a hozzá használt MNB-középárfolyam
• result.rateCapApplied — true, ha legalább egy periódust a 25%-os plafon vágott; a perióduson capped
• result.total — tőke + kamat + átalány
• result.rows[] — periódusonként from, to, days, mnb, rate, interest (két tizedes), yearLength, rateLabel, capped. A periódusok kerekítés előtt adódnak össze.

A teljes séma az OpenAPI leírásban van, példákkal együtt.

Hiba

A hibaüzenet a hívó gépnek szól, ezért angol. A magyar szöveg a hu mezőben marad — ezt lehet felületen kiírni —, a code pedig fordítástól független, arra érdemes programból ágazni.

{
  "ok": false,
  "code": "missing_start",
  "field": "start",
  "error": "start is required and must be a YYYY-MM-DD date (Hungarian alias: kezd)",
  "hu": "kezd (YYYY-MM-DD) kötelező",
  "docs": "/api-docs",
  "openapi": "/openapi.json"
}

Kódok: missing_principal, missing_start, invalid_start, invalid_end, end_before_start, unknown_rate_mode, invalid_json, malformed_json, invalid_url, unknown_endpoint, method_not_allowed.