API-Endpunkte und Berechtigungen

Verfügbare Endpunkte

Die Abomate REST-API bietet CRUD-Endpunkte für alle wichtigen Ressourcen:

Verträge (Licenses)

Methode	Endpunkt	Beschreibung
`GET`	`/v1/licenses`	Alle Verträge abrufen (Paginierung, Filter)
`GET`	`/v1/licenses/{id}`	Einzelnen Vertrag abrufen
`POST`	`/v1/licenses`	Neuen Vertrag erstellen
`PUT`	`/v1/licenses/{id}`	Vertrag aktualisieren
`DELETE`	`/v1/licenses/{id}`	Vertrag löschen

Weitere Endpunkte

Ressource	Endpunkte
Kategorien	`GET/POST/PUT/DELETE /v1/categories`
Abteilungen	`GET/POST /v1/departments`
Kontakte	`GET/POST /v1/contacts`
Benutzer	`GET /v1/users` (nur lesen)
Statistiken	`GET /v1/stats`

Berechtigungen (Scopes)

Beim Erstellen eines API-Tokens wählst du granulare Berechtigungen:

Scope	Beschreibung
`licenses:read`	Verträge lesen
`licenses:write`	Verträge erstellen und bearbeiten
`licenses:delete`	Verträge löschen
`categories:read` / `write`	Kategorien lesen / schreiben
`departments:read` / `write`	Abteilungen lesen / schreiben
`contacts:read` / `write`	Kontakte lesen / schreiben
`users:read`	Benutzer lesen (kein Schreibzugriff)
`stats:read`	Statistiken abrufen
`credentials:write`	Zugangsdaten (Passwörter, Keys) schreiben

Rate-Limiting

Standardmäßig sind 60 Anfragen pro Minute pro Token erlaubt. Das Limit kann pro Token individuell angepasst werden.

Bei Überschreitung erhältst du den HTTP-Status 429 Too Many Requests mit einem Retry-After-Header.

Antwortformat

Alle Antworten im JSON-Format mit englischen Feldnamen. Beispiel:

{
  "data": {
    "id": 1,
    "name": "Microsoft 365",
    "provider": "Microsoft",
    "status": "active",
    "cost": 12.50,
    "billing_cycle": "monthly"
  }
}

Tipp: Die vollständige interaktive API-Dokumentation findest du unter Einstellungen → API → API-Docs – dort kannst du alle Endpunkte direkt ausprobieren.