Ordlista
Webhook vs API
En webhook är hur ett system säger till ett annat att något har hänt. Ett API är hur ett system frågar ett annat efter aktuellt läge. Headless e-handel använder båda, hela tiden, för olika jobb.
En webhook är en envägs-notifiering som triggas när något händer i ett system. Ett API är en tvåvägs-kanal som svarar när du ställer en fråga. Båda hör hemma i varje headless e-handelsstack. Varje gör ett jobb som det andra gör dåligt.
Webhooks passar för händelser som är tidskritiska och förutsägbara. Order skapad. Lagernivå ändrad. Supportärende öppnat. Producenten vet exakt när notifieringen ska skickas. Konsumenten behöver inte fråga på schema.
API:er passar för allt som kräver aktuellt läge eller en sökning. Visa alla produkter i en kategori. Sök i sortimentet. Hämta kundens orderhistorik. Konsumenten frågar, producenten svarar med data.
## Båda mönstren i en Frntkey-storefront
I en Frntkey-storefront körs båda mönstren parallellt. Norce-backenden skickar en webhook till Junipeer när en order läggs. Junipeer dirigerar datan till Fortnox eller Business Central för bokföring. Ingen polling, ingen fördröjning, inga missade ordrar.
Samma storefront använder Norce API för att hämta produktdata när en kategorisida laddas. API-anropet sker som del av server-side rendering. Webhooken är inte inblandad i det flödet alls.
## Hur var och en fallerar
De två mönstren fallerar olika. En webhook fallerar när konsumenten är nere. Producenten skickar, ingen lyssnar, händelsen är förlorad. Robusta webhook-flöden behöver retry-logik hos producenten, eller en kö mellan producent och konsument. Storyblok skickar innehållswebhooks till Frntkey med båda. Vercel kvitterar mottagning, köar revalideringen, och tolererar korta avbrott hos konsumenten.
Ett API fallerar när producenten överbelastas. För många samtidiga anrop, svarstider försämras, storefront blir långsam. Robusta API-flöden behöver cachning, rate limiting och graceful degradation. Frntkey cachar commerce-API-svar där datan tål en kort fördröjning. Produktdata revalideras några gånger i minuten. Lagernivåer cachas inte alls.
## Det vanliga misstaget
Det vanligaste arkitekturmisstaget är att använda webhooks för det ett API ska göra. Att polla en webhook-mottagare varje minut för att simulera API-beteende. Eller att använda API:er för det en webhook ska göra. Att väcka ett cron-jobb var femte minut för att kolla nya ordrar. Båda misstagen kostar realtids-latens och skapar onödig drift.
Rätt arkitektur: webhooks för händelser, API:er för läge. Frntkey kopplar båda från start. Storyblok-innehållswebhooken revalideras efter publicering. Commerce-API:t renderar storefront vid varje request. Varje verktyg gör det det gör bäst.
Vanliga frågor
Vill du prata?
Se hur Frntkey passar din stack. Boka 30 minuter.
Boka demo