API
När din egen kod behöver läsa data eller utföra en dokumenterad åtgärd i Alunta.
Hitta din endpointAlunta för utvecklare
Bygg det dina kunder älskar. Låt Alunta ta hand om abonnemangen.
Bygg din produkt. Låt Alunta sköta abonnemangen. Anslut kunddata och återkommande avtal via API:et.
REST API · JSON · OpenAPI
Din produktCRM · app · din checkout
REST APILäs data och utför åtgärder
AluntaKunder · prenumerationer · fakturor
WebhooksFå besked när något ändras
Mindre dubbelarbete. Mer produkt.
Kunder ska inte behöva läggas upp två gånger och teamet ska inte flytta siffror för hand. Koppla ihop arbetsflödena du redan har och låt Alunta sköta abonnemangen i bakgrunden.
Känn kunden där du arbetar
Visa kundens abonnemang i ditt eget system så att sälj och support har avtalet nära till hands. API:t ger kunddata och referenser som du kan koppla till resten av verksamheten.
GET /customersFrån din produkt till ett nytt abonnemang
Låt kunder välja i appen och köpa via Aluntas checkout. En checkout-session och händelsen efter köpet kopplar upplevelsen till produkten.
POST /checkout-sessionsGör användning till affär
Säljer du efter användning? Skicka mätvärden från appen till Alunta och ta med dem i abonnemangets användningsbaserade fakturering. Du bygger produkten; Alunta kopplar mätvärdena till avtalet.
POST /subscriptions/{uuid}/usage
Från idé till anslutning
Din första anslutning är närmare än du tror.
Du behöver inte bygga hela integrationen på en gång. Hämta kunderna, granska svaret och fortsätt därifrån. Dokumentationen och ett första exempel finns redo.
Förbered åtkomsten
Aktivera API-åtkomst i Alunta och använd en åtkomsttoken för kontot som integrationen ska arbeta med. Åtkomsten följer tokenens behörigheter och det tillhörande kontot.
Hämta dina kunder
Lagra tokenen säkert på servern som ALUNTA_TOKEN och kör exemplet. Anropet läser kunduppgifter utan att ändra data.
Bygg vidare på svaret
Använd kundernas UUID för att koppla ihop resten av flödet. I referensen hittar du fälten och anropen som integrationen behöver.
Ditt första API-anrop
Exemplet använder den dokumenterade v1-adressen och bearer-autentisering. Du behöver en giltig token med kundåtkomst i ditt Alunta-konto.
Läs kom igång-guidenGET /api/v1/customers
curl --request GET \
'https://app.alunta.com/api/v1/customers' \
--header "Authorization: Bearer $ALUNTA_TOKEN" \
--header 'Accept: application/json'ALUNTA_TOKEN är en miljövariabel i din egen miljö. Förvara tokenen på servern och utanför källkod, webbläsarkod och loggar.
När dina data ändras
Låt systemen hålla varandra uppdaterade.
Ett abonnemang ändras. En betalning registreras. Produkten kan få besked och fortsätta medan teamet ägnar tiden åt kunderna. Det är vad webhooks är till för.
Välj relevanta händelser och ta emot dem på din HTTPS-endpoint. Dokumentationen beskriver signaturer, leverans och nya försök.
Kontrollera avsändaren
Verifiera signaturen mot den råa request-body:n enligt dokumentationen innan du behandlar händelsen.
Svara snabbt och fortsätt sedan
Ta emot leveransen och lägg det fortsatta arbetet i din egen kö. Dokumentationen anger den aktuella tidsgränsen för svar.
Hantera nya försök
En händelse kan levereras flera gånger. Se till att en upprepad leverans inte utlöser samma åtgärd igen.
Ge kodassistenten något användbart att arbeta med.
Bygger du med en kodassistent? Ge den Aluntas OpenAPI-fil och dokumentation så att den använder rätt endpoints och svar. Då får du en konkret start för integrationen och mer tid till din egen kod.
Kom vidare när något fastnar.
Ett API-svar visar nästa steg. Här är tre vanliga meddelanden och vad du kan göra.
401 / 403Kontrollera åtkomsten- Kontrollera token, behörigheter och om API-modulen är tillgänglig för kontot.
422Kontrollera innehållet- Läs valideringsfelet och endpointens krav på fält och åtgärder.
429Ge anropet tid- Följ Retry-After och begränsa samtidiga anrop. Läsningar och skrivningar har separata kvoter.
Har du fastnat? Skicka X-Request-Id så hjälper vi dig att hitta anropet. Skrivningar och misslyckade anrop visas under Inställningar → API → Logg. Dela inte tokenen.
Det finns fler sätt att minska arbetet.
MCP
När en kompatibel AI-assistent ska arbeta med utvald information och verktyg från kontot.
Utforska AI-åtkomstIntegrationer och Zapier
När en befintlig anslutning eller ett arbetsflöde kan göra jobbet åt dig.
Hitta en integrationBra frågor. Nu kommer du vidare.
Kan API:t arbeta med alla mina Alunta-konton?
En token ger åtkomst till det tillhörande kontot och de åtgärder som behörigheterna tillåter. Planera kontoanslutningen i integrationen. Använd /me för att se sammanhanget för det autentiserade kontot.
Kan jag använda API:t från en webbläsare?
Förvara tokenen på servern. Låt servern anropa Alunta och skicka bara den information gränssnittet behöver. Lägg inte API-tokenen i offentlig webbläsarkod.
Vad gör jag om jag behöver en annan endpoint?
Berätta om arbetsflödet och informationen eller åtgärden du behöver. Vi undersöker det gärna tillsammans. Den offentliga referensen visar vad du kan bygga i dag.
Kan ni hjälpa mig med integrationen?
Ja. Skicka en beskrivning av vad du vill koppla ihop, endpointen och eventuell HTTP-status eller X-Request-Id till support@alunta.com. Skicka inte token eller känsliga kunduppgifter.
Vad vill du koppla till Alunta?
Har du en idé, en frustrerande manuell uppgift eller en integration du vill bygga? Prata med oss. Vi hjälper gärna till att hitta en bra koppling mellan produkten och Alunta.
Låt oss bygga anslutningen tillsammansBörja med API:et
Använd det dokumenterade API:et för kund- och abonnemangsåtgärder som stöds. Skydda inloggningsuppgifterna.
Få uppdateringar med webhooks
Låt webhooks meddela din programvara om händelser som stöds. Planera för återförsök och kontrollera inkommande anrop.
Testa hela flödet
Testa hela flödet före start. Dokumentationen beskriver tillgängliga åtgärder och begränsningar.
