Widget vagy API: melyiket válaszd?
Egy script tag, és már fut is a vásárlási felület. Vagy heteket építesz saját UI-t, és cserébe teljes kontrollt kapsz. A Komashi mindkettőt támogatja — a kérdés az, melyik illik a projektedhez.
A widget egy kész, beágyazható felület, nincs szükség saját fejlesztésre. Az API teljes kontrollt ad, de saját UI-t és backend logikát igényel. Gyors indításhoz a widget, egyedi rendszerintegrációhoz az API a jobb út.
Mikor jó választás a widget?
A widget egy előre megépített felület, amit egyetlen script taggal illeszthetsz be. Nincs szükség sem saját frontend fejlesztésre, sem backend módosításra.
Amire szükséged lesz:
- Érvényes Komashi API-kulcs
- Script tagot betölteni képes weboldal
data-keyésdata-modeattribútum beállítása
A widget automatikusan kezeli a szolgáltatáslista megjelenítését, az előfizetési folyamatot és a Komashi API-val való kommunikációt.
Mikor éri meg az API-t választani?
Az API-val programozottan éred el és módosítod a Komashi adatait — providereket, szolgáltatásokat, ügyfeleket, előfizetéseket és számlákat. Minden kérést egy Bearer token azonosít.
Az API akkor a jobb út, ha:
- saját, egyedi felhasználói felületet építesz
- meglévő ügyfélportálhoz vagy belső dashboardhoz kell csatlakoztatnod a Komashit
- webhookokkal kombinálva valós idejű szinkronizációra van szükséged egy másik rendszerrel
→ API dokumentáció
Fejlesztési idő és rugalmasság
| Widget | API | |
|---|---|---|
| Fejlesztési idő | Alacsony | Magasabb |
| Saját UI szükséges | Nem | Igen |
| Backend szükséges | Nem | Általában igen |
| Rugalmasság | Korlátozott | Teljes |
A widget percek alatt üzemel, de azt kapod, amit a widget kínál. Az API teljes kontrollt ad a megjelenés és a logika felett, cserébe saját hibakezelést és jogosultságkezelést igényel.
Kinek melyik való?
- Gyors indítást keresel fejlesztői kapacitás nélkül → widget
- Saját brandeddel egyedi felhasználói élményt építesz → API
- CRM-hez vagy belső rendszerhez kötnéd a Komashit → API
- Csak meg akarod jeleníteni a szolgáltatásaidat a weboldaladon → widget
A két megoldás nem zárja ki egymást. Sok provider widgettel indul, majd később API-integrációra vált, ahogy a rendszere összetettebbé válik.