find_car
Hitta bil efter behov
Ger en rangordnad shortlist av bilar utifrån behov (budget kr/mån, bagage, räckvidd, drivmedel, märken, mil/år) med total månadskostnad, kostnadsuppdelning och motivering. Använd först när användaren vill ha hjälp att välja bil.
輸入參數arlimitmarkenmilPerArdrivmedelprioritetanskaffningminRackviddKmbudgetPerManadminLastutrymmeLiter
Jämför 2–5 bilar (id från find_car) sida vid sida: total månadskostnad, kostnadsposter och skillnad mot billigaste.
輸入參數arids必填milPerAranskaffning
total_cost
Total bilkostnad per månad
Räknar total ägandekostnad (TCO) per månad för valfri bil i Sverige: värdeminskning, ränta eller leasing, drivmedel/el, försäkring, fordonsskatt (inkl. malus enligt Transportstyrelsen), service, däck, besiktning. Ange pris (köp) eller leasingPerManad (privatleasing).
輸入參數arprisrantaelprismilPerArdrivmedelbensinprisdieselprisanskaffningforbrukningco2GramPerKmservicePerAr另有 5 個
list_campaigns
Aktuella privatleasingkampanjer
Listar insamlade privatleasingkampanjer från svenska återförsäljare/leasingbolag, sorterat på jämförbart månadspris. Filtrera på maxPerManad, märke eller fritext. Varje rad har insamlingsdatum och länk som användaren kan öppna.
輸入參數soklimitmarkemaxPerManad
create_watch
Bevaka bilkampanjer
Skapar en bevakning så användaren får mejl om nya kampanjer som matchar (pris, märke, fritext). Kräver e-post och uttryckligt samtycke – fråga användaren innan du anropar. Inga mejl skickas förrän användaren bekräftat (dubbel opt-in). Om användaren är inloggad (OAuth) blir anropet ett utkast som måste godkännas via confirm_action, och e-post tas från kontot.
輸入參數sokemail必填markesamtycke必填drivmedelmaxPerManad
explain_costs
Förklara regler och antaganden
Returnerar reglerna (fordonsskatt, malus) med källor och alla standardantaganden som kalkylen använder.
無需輸入參數。
get_my_profile
Min bilprofil
Kräver inloggning. Hämtar användarens sparade profil (mil/år, ägandetid, anskaffning, budget, försäkring, energipriser) som används i my_monthly_cost.
無需輸入參數。
my_monthly_cost
Vad kostar bil X per månad för mig
Kräver inloggning. Räknar total månadskostnad för en bil (bilId från find_car) med användarens profil (mil/år, år, anskaffning, försäkring, energipris, ränta). Argument i anropet överstyr profilen.
輸入參數arbilId必填rantaelprispostortmilPerArdrivmedelbensinprisdieselprisanskaffningbudgetPerManadforsakringPerAr另有 1 個
save_profile
Spara min bilprofil (kräver bekräftelse)
Kräver inloggning. Steg 1 av 2: skapar ett UTKAST av profilen och returnerar bekraftelseId. Inget sparas förrän confirm_action anropas efter att användaren uttryckligen godkänt.
輸入參數arrantaelprispostortmilPerArdrivmedelbensinprisdieselprisanskaffningbudgetPerManadforsakringPerArkontantinsatsAndel
confirm_action
Genomför godkänd åtgärd
Kräver inloggning. Steg 2 av 2: utför en åtgärd från save_profile/create_watch. Anropa ENDAST efter att användaren uttryckligen sagt ja till sammanfattningen, med user_confirmed=true. Bekräftelse-id gäller 10 minuter och en gång.
輸入參數bekraftelseId必填user_confirmed必填