API
Når din egen kode skal hente data eller udføre en dokumenteret handling i Alunta.
Find dit endpointAlunta til udviklere
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
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.
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 /customersLad 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-sessionsSæ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}/usageFra idé til forbindelse
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.
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.
Gem tokenet sikkert på din server som ALUNTA_TOKEN, og kør eksemplet. Kaldet henter oplysninger om kunder og ændrer ingen data.
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.
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 gangcurl --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
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.
Brug den dokumenterede signaturkontrol på den rå request-body, før du behandler hændelsen.
Tag imod leveringen, og læg det efterfølgende arbejde i din egen kø. Dokumentationen angiver den aktuelle svartidsgrænse.
En hændelse kan blive leveret igen. Indret behandlingen, så samme levering ikke udløser den samme handling flere gange.
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.
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 adgang422Kontrollér indholdet429Giv kaldet tidSidder 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.
Når din egen kode skal hente data eller udføre en dokumenteret handling i Alunta.
Find dit endpointNår en kompatibel AI-assistent skal arbejde med udvalgte oplysninger og værktøjer fra din konto.
Se AI-adgangNår en færdig forbindelse eller et workflow kan løse opgaven for dig.
Find en integrationEt 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.
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.
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.
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.
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