Unter Admin Panel → Plugins → API Endpoints → Konfigurieren stehen folgende Einstellungen zur Verfügung:
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Enable API Endpoints | Schaltet alle erweiterten Endpunkte global ein/aus. Der Zugriff pro Endpunkt wird zusätzlich über die API-Key-Berechtigungen gesteuert. | aktiviert |
| Require Markdown Plugin | Wenn aktiviert, lehnt die API eine Ticket-Erstellung mit format=markdown ab, falls das Markdown Support Plugin nicht aktiv ist. Wenn deaktiviert, wird die Anfrage stattdessen als html verarbeitet. |
deaktiviert (nachsichtig) |
| Installed Version | Rein informativ, wird vom Plugin automatisch verwaltet (Auto-Update-Tracking) — nicht manuell bearbeiten. | automatisch |
Das Plugin erweitert osTickets API-Key-Berechtigungssystem mit granularen Permissions.
| Berechtigung | Datenbank-Feld | Gewährt Zugriff auf |
|---|---|---|
| Tickets erstellen | can_create_tickets |
POST /tickets |
| Tickets lesen | can_read_tickets |
GET /tickets/:number, GET /tickets-attachment-download/:file_id |
| Tickets aktualisieren | can_update_tickets |
PATCH /tickets/:number |
| Tickets suchen | can_search_tickets |
GET /tickets/search |
| Tickets löschen | can_delete_tickets |
DELETE /tickets/:number |
| Statistiken lesen | can_read_stats |
GET /tickets-stats, GET /tickets-statuses |
| Subtickets verwalten | can_manage_subtickets |
Alle Subticket-Endpunkte (benötigt Subticket Manager Plugin) |
Die genaue Zuordnung Endpunkt → Berechtigung steht in der API-Dokumentation (Englisch).
Das Plugin unterstĂĽtzt Legacy-API-Keys (ohne die neuen Berechtigungsspalten):
can_create_tickets → Fallback zu canCreateTickets() (osTicket-Standardverhalten)can_read_tickets → Fallback zu canCreateTickets() (Lesen wird wie Erstellen behandelt)can_update_tickets → Fallback zu canCreateTickets()Migriere ältere API-Keys auf die neuen Berechtigungen, um granulare Kontrolle zu erhalten — ohne Migration funktionieren sie unverändert weiter.
can_read_statscan_create_ticketsTipp:
can_delete_ticketsist standardmäßig deaktiviert. Erwäge stattdessen einPATCHauf Status „Closed"/„Archived" statt Tickets endgültig zu löschen.