Indlæser...
Indlæser...
Integrer CarTech Groups beregningsmotor direkte i jeres systemer. Fuldt dokumenteret REST API med JSON request/response.
CarTech Groups REST API giver enterprise-kunder direkte adgang til beregningsplatformen uden brug af brugergrænsefladen.
Samme motorer som platformen — opdateret med seneste SKAT-satser og afgiftsregler.
Gennemsnitlig responstid under 120 ms. Redis-cache på skattetabeller for konsistent ydeevne.
Stabil v1-kontrakt med backwards compatibility. Deprecation-varsel minimum 6 måneder før ændringer.
Alle API-kald kræver en gyldig API-nøgle sendt som HTTP-header. Nøgler genereres fra dit dashboard under Indstillinger → API.
Send din API-nøgle i headerenX-API-Keymed alle anmodninger. Nøgler har præfiksetctk_live_(produktion) ellerctk_test_(test).
GET /v1/any-endpoint HTTP/1.1
Host: api.cartechgroup.dk
X-API-Key: ctk_live_your_api_key_here
Content-Type: application/json
Accept: application/jsonGem aldrig API-nøgler i klientside-kode eller versionsstyring. Brug miljøvariabler (f.eks.CARTECH_API_KEY).
Alle endepunkter er tilgængelige under base URL nedenfor. API-versionen er inkluderet i stien for at sikre bagudkompatibilitet ved fremtidige opdateringer.
# Produktion
https://api.cartechgroup.dk/v1
# Test / Staging
https://api-test.cartechgroup.dk/v1
# Fuldt eksempel
https://api.cartechgroup.dk/v1/tax/calculateAlle requests kræver HTTPS. HTTP-forbindelser afvises med301 Redirect.
Tre beregningsendepunkter dækker registreringsafgift, leasingydelse og restværdiestimering. Alle returnerer JSON.
/v1/tax/calculate—Beregn registreringsafgiftBeregner den fulde registreringsafgift for et køretøj baseret på pris, drivmiddel, CO2-udledning og type. Returnerer afgiftsbeløb og detaljeret nedbrydning.
| Felt | Type | Krav | Beskrivelse |
|---|---|---|---|
vehicle_price | number | Påkrævet | Køretøjets pris ekskl. afgifter (DKK) |
fuel_type | string | Påkrævet | "petrol" |"diesel" |"electric" |"hybrid" |"plugin_hybrid" |
co2_gkm | number | Påkrævet | CO2-udledning i gram pr. km (WLTP) |
vehicle_type | string | Påkrævet | "passenger" |"van" |"motorcycle" |
is_new | boolean | Valgfri | Nyt køretøj (standard: true) |
POST /v1/tax/calculate
Content-Type: application/json
X-API-Key: ctk_live_your_api_key_here
{
"vehicle_price": 425000,
"fuel_type":"petrol",
"co2_gkm": 142,
"vehicle_type":"passenger",
"is_new": true
}HTTP/1.1 200 OK
Content-Type: application/json
{
"registration_tax": 198340,
"green_tax_annual": 4200,
"breakdown": {
"base_value": 425000,
"taxable_value": 409875,
"first_bracket_tax": 113475,
"second_bracket_tax": 84865,
"co2_supplement": 12600,
"deductions_applied": 15125,
"effective_rate": 0.4667
},
"calculated_at":"2025-03-14T10:30:00Z",
"disclaimer":"Beregning er vejledende. Kontakt SKAT for endelig afgørelse."
}/v1/leasing/calculate—Beregn leasingydelseBeregner månedlig leasingydelse og de samlede omkostninger over leasingperioden. Understøtter finansiel leasing med brugerdefinerede parametre.
| Felt | Type | Krav | Beskrivelse |
|---|---|---|---|
vehicle_price | number | Påkrævet | Køretøjets fulde pris inkl. afgifter (DKK) |
term_months | integer | Påkrævet | Leasingperiode i måneder (12–84) |
interest_rate | number | Påkrævet | Nominel årlig rentesats (f.eks. 0.049 = 4,9%) |
down_payment_pct | number | Valgfri | Udbetaling som andel af pris (0.0–0.5, standard: 0.0) |
residual_value_pct | number | Valgfri | Restværdi som andel af pris (0.1–0.6, standard: 0.3) |
POST /v1/leasing/calculate
Content-Type: application/json
X-API-Key: ctk_live_your_api_key_here
{
"vehicle_price": 623340,
"term_months": 36,
"interest_rate": 0.049,
"down_payment_pct": 0.1,
"residual_value_pct": 0.35
}HTTP/1.1 200 OK
Content-Type: application/json
{
"monthly_payment": 8245,
"total_cost": 296820,
"breakdown": {
"financed_amount": 561006,
"down_payment": 62334,
"residual_value": 218169,
"total_interest": 34353,
"monthly_principal": 7564,
"monthly_interest": 681
},
"calculated_at":"2025-03-14T10:31:00Z",
"disclaimer":"Beregning er vejledende. Endelige betingelser fastsættes af leasingselskabet."
}/v1/residual-value/estimate—Estimér restværdiEstimerer et køretøjs restværdi baseret på mærke, model, drivmiddel, alder og kilometerstand. Returnerer estimeret handelsværdi og en confidence score.
| Felt | Type | Krav | Beskrivelse |
|---|---|---|---|
brand | string | Påkrævet | Bilmærke (f.eks."Toyota","BMW") |
model | string | Påkrævet | Bilmodel (f.eks."Corolla","3 Series") |
fuel_type | string | Påkrævet | "petrol" |"diesel" |"electric" |"hybrid" |"plugin_hybrid" |
purchase_price | number | Påkrævet | Oprindelig købspris inkl. afgifter (DKK) |
age_months | integer | Påkrævet | Køretøjets alder i måneder |
mileage_km | integer | Påkrævet | Aktuel kilometerstand |
POST /v1/residual-value/estimate
Content-Type: application/json
X-API-Key: ctk_live_your_api_key_here
{
"brand":"Toyota",
"model":"Corolla",
"fuel_type":"hybrid",
"purchase_price": 385000,
"age_months": 30,
"mileage_km": 45000
}HTTP/1.1 200 OK
Content-Type: application/json
{
"estimated_value": 268500,
"depreciation_pct": 0.3026,
"confidence_score": 0.87,
"value_range": {
"low": 251000,
"mid": 268500,
"high": 284000
},
"factors": {
"age_impact": -0.18,
"mileage_impact": -0.09,
"fuel_type_modifier": 0.04,
"market_demand_modifier": 0.03
},
"calculated_at":"2025-03-14T10:32:00Z",
"disclaimer":"Estimat baseret på markedsdata. Faktisk handelsværdi kan afvige."
}API-kald er begrænset pr. API-nøgle afhængigt af din plan. Grænser nulstilles hvert minut.
Starter
100 req/min
Maks. 5.000 req/dag
Professional
500 req/min
Maks. 50.000 req/dag
Business+
AnbefaletUbegrænset
Ingen daglig grænse — SLA garanti
Hvert svar indeholder headers der viser din nuværende status:
HTTP/1.1 200 OK
X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1710412260
# Ved overskredet grænse:
HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 500
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1710412260Alle fejlsvar returneres med konsistent JSON-struktur. Felternes betydning er beskrevet nedenfor.
{
"error": {
"code": 400,
"type":"validation_error",
"message":"Feltet'co2_gkm' skal vaere et positivt tal",
"field":"co2_gkm",
"request_id":"req_7f3a9b2c1d4e"
}
}Bad RequestUgyldig anmodning. Kontrollér at alle påkrævede felter er til stede og har korrekt type. Fejlmeddelelsen indeholder detaljer om det specifikke felt.
UnauthorizedAPI-nøgle mangler eller er ugyldig. Sørg for at sende headeren"X-API-Key: <din_nøgle>" med alle anmodninger.
ForbiddenDin plan giver ikke adgang til dette endpoint. API-adgang kræver minimum Professional-plan.
Too Many RequestsRate limit overskredet. Headeren Retry-After angiver antal sekunder til at vente. Overvej at opgradere din plan for højere grænser.
Internal Server ErrorUventet fejl på vores servere. Fejlen er logget og vores team er notificeret. Prøv igen om lidt eller kontakt support.
API-adgang er tilgængeligt fra Professional-planen og opefter. Kontakt os for en enterprise-aftale med dedikeret SLA og teknisk onboarding.