Grants

Nutzung & Abrechnung

Faire API-Nutzung im Rahmen der Anfragelimits ist in jedem Plan inbegriffen - die Integration soll sich nicht künstlich kompliziert anfühlen, nur weil ein günstigerer Plan gebucht ist. Enterprise-Kunden bekommen angepasste Limits nach Bedarf.

On-Demand-Betreuung ist verfügbar, und unser Entwicklerteam baut bei Bedarf maßgeschneiderte Integrationen - sprich uns an, wenn dein Anwendungsfall mehr braucht als die Standardanbindung.

Schnellstart

1. 1

   Token erstellen

   Öffne in Grants das Integrationen-Menü, klicke *Neues Token*, wähle Name und Berechtigungen, kopiere den pat_… Wert. Er wird genau einmal angezeigt.

2. 2

   Erste Anfrage senden

   Token als Bearer-Header an einen Grants-Endpunkt senden, den deine Berechtigungen abdecken. Paginierung, Filter und Sortierung sind pro Modell dokumentiert.

   curlJavaScriptPython

   Copy

   curl -H "Authorization: Bearer pat_…" \
        https://granttool.de/xapi2/data/derived_doc

3. 3

   Live-Updates abonnieren

   Mit einem einzelnen WebSocket alle Create/Update/Delete-Ereignisse in Echtzeit empfangen - gleiche Zugriffsregeln, gleiches Token. Polling entfällt.

   WebSocket

   Copy

   const ws = new WebSocket(`wss://${location.host}/xapi2/ch?token=${token}`)
   ws.onopen = () => ws.send(
     JSON.stringify({ op: "subscribe", id: "s1", dataType: "derived_doc" }),
   )
   ws.onmessage = (e) => console.log(JSON.parse(e.data))

Wegweiser

Diese Dokumentation beschreibt jeden Endpunkt, den die App öffentlich macht. Modell-Seiten enthalten konkrete Code-Beispiele in curl, JavaScript, TypeScript und WebSocket.

Datenmodelle

Produktionsreife, branchenübliche Datenmodelle. Jedes Objekt wird sicher verwaltet - Validierung, Zugriffsregeln und Audit laufen einheitlich auf jedem Pfad - und die Daten gehören jederzeit dem jeweiligen Kunden. Export und Löschung sind selbstverständlich.