# API-et dekker alt i grensesnittet

Hver skjerm i Krokul går på det samme API-et som er åpent for deg: nøkler med rolletilganger, webhooks med nye forsøk, dokumentasjon generert fra koden og MCP for AI-agenter.

**Kort fortalt.** Krokul er en B2B-CRM med et offentlig API v1 som dekker alle data og handlinger i grensesnittet, fordi grensesnittet selv går på det. API-nøkler opprettes med rolletilganger og en logg over kall; webhooks sender hendelser (avtale, dokument, betaling, kundebedrift) med leveringskø, nye forsøk og logg; den engelske dokumentasjonen genereres fra kodespesifikasjonen og har eksempler fra ekte svar; MCP-serveren lar AI-agenter lese og handle innenfor nøkkelens tilganger. Alt dette er del av produktet, ikke en dyrere plan.

**Plan:** Tilgjengelig fra «Penger»-planen, $149 per måned; MCP og høyere grenser på «Margin»

## Slik ser det ut uten Krokul

2. En webhook kom ikke fram fordi kundens server var nede i tre minutter. Hendelsen er tapt, ordren blir ikke opprettet, og ingen merker det.
3. API-et finnes bare på den dyre planen, og dokumentasjonen er tre sider uten eksempler. Integrasjonen koster mer enn CRM-en.

## Hva Krokul gjør

### Ett API for skjermen og for deg

Grensesnittet i Krokul kaller de samme rutene som en API-nøkkel åpner. Et felt du ser på skjermen, finnes også i API-et, fordi det er bygd slik, ikke fordi det er lovet.

### Nøkler med rolletilganger

En nøkkel opprettes for en rolle: selger, regnskapsfører, bare lesing. Det rollen ikke kan gjøre, kan heller ikke nøkkelen; hvert kall logges.

### Webhooks med kø

Hendelser om avtaler, dokumenter, betalinger og kundebedrifter sendes til din URL med kø, nye forsøk ved feil og leveringslogg. Hendelser som ikke ble levert, er synlige og kan sendes på nytt manuelt.

### Dokumentasjon fra koden, og MCP

Spesifikasjonen utledes fra koden og eksemplene fra ekte svar, så dokumentasjonen blir ikke utdatert. MCP-serveren kobler til AI-agenter med de samme tilgangene som nøkkelen.

## Slik fungerer det

1. **Opprett en nøkkel for en rolle** I innstillingene: navn, rolle, utløpsdato. Nøkkelen ser nøyaktig det en person med den rollen ville sett.
2. **Les dokumentasjonen med eksempler** Engelsk dokumentasjon som beskriver hver rute og feltene, med eksempler på svar, på adressen det lenkes til i bunnteksten på nettstedet.
3. **Koble til webhooks** En URL og hendelser; leveringsloggen viser hvert forsøk med svarkode. Ved feil prøver den på nytt etter plan eller manuelt.
4. **Koble til en agent gjennom MCP** En nøkkel og MCP-adressen, så leser en ekstern AI-agent data og foreslår handlinger innenfor tilgangene sine, med den samme loggen.

## Resultat

- Ingen hendelse går tapt: køen og de nye forsøkene leverer webhooken, og loggen viser hvert forsøk.
- API, webhooks og MCP prises ikke for seg: de er del av produktet.

## Hva som ikke er med

## Spørsmål

### Dekker API-et virkelig alt?

Ja, fordi grensesnittet går på de samme rutene: vi har ikke et eget «internt» API med flere muligheter.

### Hvordan begrenser jeg hva en nøkkel kan se?

Med rollen. En nøkkel med bare lesing kan ikke opprette noe; en nøkkel med selgerrollen ser ikke kostpris. Serveren håndhever dette.

### Hva om en webhook ikke kommer fram?

Leveringsloggen viser forsøket og svarkoden; nytt forsøk skjer automatisk etter plan eller manuelt med en knapp.

### Hva er MCP, og hvorfor trenger jeg det?

En protokoll AI-agenter bruker for å lese data og kalle handlinger. Krokul har sin egen MCP-server: koble til en agent med en nøkkel, så ser den nøyaktig det rollen tillater.

### Hva koster API-et?

API, nøkler og webhooks er inkludert i «Penger»-planen, $149 per måned; MCP og høyere grenser for kall er på «Margin»-planen. Poster som opprettes gjennom API-et, telles som transaksjoner på samme måte som de som opprettes på skjermen.

### Hvordan kobler jeg til en tjeneste som ikke finnes i Marketplace?

Med en egen integrasjonsregel: Kro lager den ut fra beskrivelsen din, regelen testkjøres på eksempelhendelser og kan bare slås på etter testen. Tjenesten sender en hendelse til regelens adresse — Krokul finner avtalen, dokumentet eller kontakten og oppretter en betaling, kontakt eller oppgave; hver hendelse blir liggende i loggen. Egne regler er med i Margin-planen.

## Åpne dokumentasjonen og send din første forespørsel

Opprett en nøkkel i innstillingene, kall ruten for «kundebedrifter» og få listen din, på fem minutter, uten å skrive til støtten.

Inkludert i «Penger»-planen.

## Neste i kjeden

- [Automatisering: systemet tar rutinen og viser hvorfor](https://krokul.com/no/solutions/automations/index.md)
- [Rollen avgjør hvem som ser hva. Serveren håndhever det](https://krokul.com/no/solutions/security/index.md)
- [Dataene er dine: API, eksport og tilbakerulling fra første dag](https://krokul.com/no/solutions/data/index.md)
- [En AI-assistent som setter opp systemet med vanlige ord](https://krokul.com/no/solutions/assistant/index.md)

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs