Alunta til udviklere

Byg det, dine kunder elsker. Lad Alunta tage abonnementerne.

Der er nok på din roadmap. Lad Alunta håndtere abonnementerne, mens du bygger det, der gør dit produkt særligt. Med vores API kan dit CRM, din app og dit checkout arbejde sammen med kunder, aftaler og fakturaer i Alunta.

REST API · JSON · OpenAPI

Dit produkt og Alunta. Samme arbejdsgang.
Dit produktCRM · app · eget checkout
REST APIHent data og udfør handlinger
AluntaKunder · abonnementer · fakturaer
WebhooksFå besked, når noget ændrer sig

Mindre dobbeltarbejde. Mere produkt.

Kunden skal ikke oprettes to gange, og dit team skal ikke flytte tal i hånden. Forbind de arbejdsgange, du allerede har, og lad Alunta være abonnementsmotoren bag dem.

  1. Kend kunden, dér hvor du arbejder

    Vis kundens abonnementer i dit eget system, så salg og support har aftalen ved hånden. API’et giver dig kundedata og referencerne til at forbinde dem med resten af din forretning.

    GET /customers
  2. Fra dit produkt til et nyt abonnement

    Lad kunden vælge i din app og købe gennem Aluntas checkout. En checkout-session og hændelsen efter købet forbinder oplevelsen med dit produkt.

    POST /checkout-sessions
  3. Gør forbrug til forretning

    Sælger du på forbrug? Send målingerne fra din app til Alunta, og lad dem indgå i abonnementets forbrugsafregning. Du bygger produktet; Alunta forbinder målingerne med aftalen.

    POST /subscriptions/{uuid}/usage

Fra idé til forbindelse

Din første forbindelse er tættere på, end du tror.

Du behøver ikke bygge hele integrationen på én gang. Hent dine kunder, se svaret, og tag næste skridt derfra. Vi har gjort dokumentationen og et første eksempel klar til dig.

  1. Gør adgangen klar

    Aktivér API-adgang i Alunta, og brug et adgangstoken til den konto, integrationen skal arbejde med. Adgangen følger tokenets rettigheder og den tilknyttede konto.

  2. Hent dine kunder

    Gem tokenet sikkert på din server som ALUNTA_TOKEN, og kør eksemplet. Kaldet henter oplysninger om kunder og ændrer ingen data.

  3. Byg videre på svaret

    Brug kundernes UUID’er til at forbinde resten af forløbet. Referencen hjælper dig videre med de felter og kald, din integration har brug for.

Dit første API-kald

Eksemplet bruger den dokumenterede v1-adresse og bearer-godkendelse. Det kræver et gyldigt token med adgang til kunder på din Alunta-konto.

Læs guiden til at komme i gang
GET /api/v1/customers
curl --request GET \
  'https://app.alunta.com/api/v1/customers' \
  --header "Authorization: Bearer $ALUNTA_TOKEN" \
  --header 'Accept: application/json'

ALUNTA_TOKEN er en miljøvariabel i dit eget miljø. Opbevar tokenet på serversiden og uden for kildekode, browserkode og logs.

Når dine data ændrer sig

Lad systemerne holde hinanden opdateret.

Et abonnement ændrer sig. En betaling bliver registreret. Dit produkt kan få besked og arbejde videre, mens teamet bruger tiden på kunderne. Det er det, webhooks er til.

Vælg de relevante hændelser, og modtag dem på dit HTTPS-endpoint. De tekniske detaljer om signaturer, leveringer og genforsøg ligger klar i dokumentationen.

  1. Kontrollér afsenderen

    Brug den dokumenterede signaturkontrol på den rå request-body, før du behandler hændelsen.

  2. Svar hurtigt, arbejd videre bagefter

    Tag imod leveringen, og læg det efterfølgende arbejde i din egen kø. Dokumentationen angiver den aktuelle svartidsgrænse.

  3. Håndtér genforsøg

    En hændelse kan blive leveret igen. Indret behandlingen, så samme levering ikke udløser den samme handling flere gange.

Giv din kodeassistent noget godt at arbejde med.

Bygger du med en kodeassistent? Giv den Aluntas OpenAPI-fil og dokumentation, så den arbejder med de rigtige endpoints og svar. Du får et konkret udgangspunkt for integrationen og mere tid til din egen kode.

Kom hurtigt videre, når noget driller.

Et svar fra API’et hjælper dig med næste skridt. Her er tre af de typiske beskeder, og hvad du kan gøre ved dem.

401 / 403Kontrollér adgang
Kontrollér token, rettigheder og om API-modulet er tilgængeligt på kontoen.
422Kontrollér indholdet
Læs valideringsfejlen og de krav, endpointet stiller til felter og handlinger.
429Giv kaldet tid
Respektér Retry-After, og begræns samtidige kald. Læse- og skrivekald har særskilte kvoter.

Sidder du fast? Send os X-Request-Id, så kan vi hjælpe med at finde kaldet. Skrivekald og fejlede kald ligger under Indstillinger → API → Log. Behold dit token hos dig selv.

Der er mere end én vej til mindre arbejde.

API

Når din egen kode skal hente data eller udføre en dokumenteret handling i Alunta.

Find dit endpoint

MCP

Når en kompatibel AI-assistent skal arbejde med udvalgte oplysninger og værktøjer fra din konto.

Se AI-adgang

Integrationer og Zapier

Når en færdig forbindelse eller et workflow kan løse opgaven for dig.

Find en integration

Gode spørgsmål. Lad os få dig videre.

Kan API’et arbejde med alle mine Alunta-konti?

Et token giver adgang til den konto, det er knyttet til, og de handlinger, rettighederne tillader. Planlæg kontotilknytningen i din integration. Brug /me, når du skal se den godkendte kontos kontekst.

Kan jeg bruge API’et fra browseren?

Tokenet skal opbevares på serversiden. Lad din egen server kalde Alunta, og giv kun din brugerflade de oplysninger, den har brug for. Del ikke dit API-token i offentlig browserkode.

Hvad hvis jeg mangler et endpoint?

Beskriv din arbejdsgang og de oplysninger eller handlinger, du mangler. Vi undersøger gerne behovet sammen med dig. Den offentlige reference viser det, du kan bygge med i dag.

Kan jeg få hjælp til min integration?

Ja. Send en beskrivelse af det, du vil forbinde, endpointet og eventuel HTTP-status eller X-Request-Id til support@alunta.com. Undlad tokens og følsomme kundedata i din henvendelse.

Hvad vil du forbinde med Alunta?

Har du en idé, et irriterende dobbeltarbejde eller en integration, du vil bygge? Skriv til os. Vi hjælper gerne med at finde den gode vej fra dit produkt til Alunta.

Lad os bygge forbindelsen sammen