API & webhooks | Hjälpcenter | Bizzzle | Hjälpcenter

REST API

Bizzzle exponerar ett REST API (v1) som returnerar JSON. Alla anrop autentiseras med en API-nyckel som skickas i headern Authorization: Bearer DIN_API_NYCKEL.

Bas-URL: https://bizzzle.se/api/v1

Fullständig API-dokumentation finns under /utvecklare i appen.

Skapa API-nyckel

Logga in i Bizzzle.
Gå till Inställningar → Utvecklare.
Klicka Skapa API-nyckel.
Ge nyckeln ett namn (t.ex. "CRM-integration") och klicka Skapa.
Kopiera nyckeln — den visas bara en gång.

Säkerhet

Förvara aldrig API-nyckeln i klientkod eller publika repos. Använd miljövariabler (t.ex. BIZZZLE_API_KEY) och rotera nyckeln om den läcker.

Endpoints

Nedan listas de vanligaste endpoints. Fullständiga parametrar och svarsformat dokumenteras under /utvecklare.

GET /api/v1/companies — Lista och filtrera företag. Stöder paginering, branschkod och geografi.
GET /api/v1/companies/:orgnr — Hämta ett enskilt företag med fullständig data.
GET /api/v1/companies/:orgnr/contacts — Hämta kontaktpersoner för ett företag.
POST /api/v1/companies/bulk — Hämta flera företag i ett anrop.
GET /api/v1/search?q=... — Fritextsökning bland företag.
GET /api/v1/filters/branches — Hämta branschkoder.

Fullständig API-referens med parametrar och svarsformat finns under /utvecklare i appen.

Webhooks

Webhooks skickar HTTP POST-notifieringar till en URL du anger när specifika händelser inträffar i Bizzzle. Det gör att ert system kan reagera i realtid utan att behöva polla API:et.

Konfigurera en webhook

Gå till Inställningar → Utvecklare → Webhooks.
Klicka Lägg till webhook.
Ange en HTTPS-URL som tar emot anropet.
Välj vilka händelser som ska trigga notifieringen.
Spara — Bizzzle skickar en test-ping för att verifiera att URL:en svarar med 2xx.

Tillgängliga händelser

deal.created — Ny deal skapad.
deal.updated — Deal uppdaterad (stage, värde etc.).
deal.won — Deal markerad som vunnen.
deal.lost — Deal markerad som förlorad.
contact.unlocked — Ny kontakt upplåst via Contact Finder.
customer.created — Ny kund tillagd.

Retry-policy

Om ert system svarar med en felkod (4xx/5xx) eller timeout gör Bizzzle upp till 5 nya försök med exponentiell backoff (1, 5, 30, 120 och 360 minuter). Efter 5 misslyckade försök inaktiveras webhooken och du meddelas via e-post.

Rate limits

API:et tillåter 100 anrop per minut per API-nyckel. Gränsen gäller alla endpoints sammanräknat.

Svarsheadern X-RateLimit-Remaining visar kvarvarande anrop i aktuellt fönster.
Vid överskriden gräns returneras 429 Too Many Requests med headern Retry-After (sekunder).

Behöver ni högre throughput? Kontakta oss — Enterprise-planen erbjuder anpassade rate limits.