API
Wenn dein eigener Code Daten lesen oder eine dokumentierte Aktion in Alunta ausführen soll.
Endpunkt findenAlunta für Entwickler
Entwickle, was deine Kunden lieben. Alunta kümmert sich um die Abonnements.
Baue dein Produkt. Alunta übernimmt die Abos. Verbinde Kundendaten und wiederkehrende Verträge über die API.
REST API · JSON · OpenAPI
Dein ProduktCRM · App · dein Checkout
REST APIDaten abrufen und Aktionen ausführen
AluntaKunden · Abonnements · Rechnungen
WebhooksBei Änderungen benachrichtigt werden
Weniger doppelte Arbeit. Mehr Produkt.
Kunden sollten nicht zweimal angelegt werden und dein Team sollte keine Zahlen von Hand übertragen. Verbinde deine bestehenden Arbeitsabläufe und lass Alunta im Hintergrund die Abonnements verwalten.
Kunden dort kennen, wo du arbeitest
Zeige Kundenabonnements in deinem eigenen System, damit Vertrieb und Support die Vereinbarung griffbereit haben. Die API stellt Kundendaten und Referenzen bereit, mit denen du sie mit dem Rest deines Geschäfts verbindest.
GET /customersVon deinem Produkt zum neuen Abonnement
Lass Kunden in deiner App auswählen und über den Alunta-Checkout kaufen. Eine Checkout-Sitzung und das Ereignis nach dem Kauf verbinden das Erlebnis mit deinem Produkt.
POST /checkout-sessionsNutzung zum Geschäftsmodell machen
Verkaufst du nach Nutzung? Sende Messwerte aus deiner App an Alunta und beziehe sie in die nutzungsbasierte Abrechnung ein. Du entwickelst das Produkt; Alunta ordnet die Messwerte der Vereinbarung zu.
POST /subscriptions/{uuid}/usage
Von der Idee zur Verbindung
Deine erste Verbindung ist näher, als du denkst.
Du musst nicht gleich die ganze Integration bauen. Rufe deine Kunden ab, prüfe die Antwort und mache von dort aus weiter. Dokumentation und ein erstes Beispiel stehen bereit.
Zugriff vorbereiten
Aktiviere den API-Zugriff in Alunta und nutze ein Zugriffstoken für das Konto, mit dem deine Integration arbeiten soll. Der Zugriff richtet sich nach den Token-Berechtigungen und dem zugehörigen Konto.
Kunden abrufen
Speichere das Token sicher auf deinem Server als ALUNTA_TOKEN und führe das Beispiel aus. Die Anfrage liest Kundendaten, ohne sie zu verändern.
Mit der Antwort weiterbauen
Nutze die UUIDs der Kunden, um den weiteren Ablauf zu verbinden. In der Referenz findest du die benötigten Felder und Anfragen.
Deine erste API-Anfrage
Das Beispiel nutzt die dokumentierte v1-URL und Bearer-Authentifizierung. Erforderlich ist ein gültiges Token mit Kundenzugriff für dein Alunta-Konto.
Einstiegsanleitung lesenGET /api/v1/customers
curl --request GET \
'https://app.alunta.com/api/v1/customers' \
--header "Authorization: Bearer $ALUNTA_TOKEN" \
--header 'Accept: application/json'ALUNTA_TOKEN ist eine Umgebungsvariable in deiner Umgebung. Bewahre das Token auf dem Server auf und halte es aus Quellcode, Browsercode und Logs heraus.
Wenn sich deine Daten ändern
Lass deine Systeme einander auf dem Laufenden halten.
Ein Abonnement ändert sich. Eine Zahlung geht ein. Dein Produkt kann davon erfahren und weiterarbeiten, während sich das Team um Kunden kümmert. Dafür sind Webhooks da.
Wähle die passenden Ereignisse und empfange sie an deinem HTTPS-Endpunkt. Details zu Signaturen, Zustellung und erneuten Versuchen stehen in der Dokumentation.
Absender prüfen
Prüfe die Signatur anhand des unveränderten Request-Bodys gemäß Dokumentation, bevor du das Ereignis verarbeitest.
Schnell antworten, später weiterarbeiten
Nimm die Zustellung an und stelle die Folgearbeit in deine eigene Warteschlange. Die Dokumentation nennt das aktuelle Zeitlimit für Antworten.
Erneute Zustellungen behandeln
Ein Ereignis kann mehrfach zugestellt werden. Sorge dafür, dass eine erneute Zustellung dieselbe Aktion nicht nochmals auslöst.
Gib deinem Coding-Assistenten eine gute Grundlage.
Entwickelst du mit einem Coding-Assistenten? Gib ihm die OpenAPI-Datei und Dokumentation von Alunta, damit er mit den richtigen Endpunkten und Antworten arbeitet. So erhältst du einen konkreten Startpunkt für die Integration und mehr Zeit für deinen eigenen Code.
Weiterkommen, wenn etwas hakt.
Eine API-Antwort zeigt den nächsten Schritt. Hier sind drei häufige Meldungen und was du tun kannst.
401 / 403Zugriff prüfen- Prüfe das Token, die Berechtigungen und ob das API-Modul für das Konto verfügbar ist.
422Inhalt prüfen- Lies den Validierungsfehler und die Anforderungen des Endpunkts an Felder und Aktionen.
429Anfrage drosseln- Beachte Retry-After und begrenze parallele Anfragen. Lese- und Schreibzugriffe haben getrennte Kontingente.
Kommst du nicht weiter? Sende uns die X-Request-Id, damit wir die Anfrage finden können. Schreib- und fehlgeschlagene Anfragen findest du unter Einstellungen → API → Protokoll. Gib dein Token nicht weiter.
Es gibt mehr als einen Weg, Arbeit zu sparen.
MCP
Wenn ein kompatibler KI-Assistent ausgewählte Informationen und Werkzeuge deines Kontos nutzen soll.
KI-Zugriff entdeckenIntegrationen und Zapier
Wenn eine vorhandene Verbindung oder ein Arbeitsablauf die Aufgabe übernehmen kann.
Integration findenGute Fragen. So kommst du weiter.
Kann die API mit allen meinen Alunta-Konten arbeiten?
Ein Token gewährt Zugriff auf das zugehörige Konto und die Aktionen, für die es berechtigt ist. Plane die Kontoverbindung in deiner Integration. Mit /me kannst du den Kontext des angemeldeten Kontos abrufen.
Kann ich die API im Browser verwenden?
Bewahre das Token auf dem Server auf. Lass deinen Server Alunta aufrufen und gib deiner Oberfläche nur die benötigten Informationen weiter. Speichere das API-Token nicht in öffentlich zugänglichem Browsercode.
Was ist, wenn ich einen weiteren Endpunkt benötige?
Erzähl uns vom Arbeitsablauf und den benötigten Informationen oder Aktionen. Wir prüfen den Bedarf gern mit dir. Die öffentliche Referenz zeigt, was du heute bauen kannst.
Könnt ihr mir bei meiner Integration helfen?
Ja. Sende eine Beschreibung der Verbindung, des Endpunkts und gegebenenfalls den HTTP-Status oder die X-Request-Id an support@alunta.com. Füge keine Tokens oder sensiblen Kundendaten bei.
Was möchtest du mit Alunta verbinden?
Hast du eine Idee, eine lästige manuelle Aufgabe oder eine Integration, die du entwickeln möchtest? Sprich mit uns. Wir helfen gern, eine passende Verbindung zwischen deinem Produkt und Alunta zu finden.
Lass uns die Verbindung gemeinsam bauenMit der API starten
Nutze die dokumentierte API für unterstützte Kunden- und Abo-Aktionen. Halte Zugangsdaten vertraulich.
Mit Webhooks informiert bleiben
Lass Webhooks deine Software über unterstützte Ereignisse informieren. Plane Wiederholungen ein und prüfe eingehende Anfragen.
Den gesamten Ablauf testen
Teste den gesamten Ablauf vor dem Start. Die Dokumentation beschreibt verfügbare Aktionen und Grenzen.
