Tickets-API
Endpoints
Alle REST-Endpunkte der Tickets-API.
Endpoints
Alle Pfade relativ zur Base-URL https://www.theredstonee.de/api/tickets/v1.
| Methode | Pfad | Beschreibung |
|---|---|---|
POST | /create.php | Ticket erstellen (pk oder sk). Felder: name, email, subject, message (Pflicht); category, fields, page_url (optional). Anhänge via multipart attachments[]. |
GET | /list.php | Tickets listen (sk only). Query: status, limit (max 200), offset. |
GET | /ticket.php?id=tkt_xxx | Einzelnes Ticket. Mit pk zusätzlich email. |
POST | /reply.php | Antwort anhängen. pk = Kunde, sk = Support. Body: ticket_id, message (+ email bei pk, author_name bei sk). |
POST | /status.php | Status ändern (sk only). Body: ticket_id, status. |
POST | /priority.php | Priorität setzen (sk only). Body: ticket_id, priority. |
POST | /assign.php | Zuweisen (sk only). Body: ticket_id, assignee (leer = entfernen). |
POST | /delete.php | Ticket löschen (sk only). Body: ticket_id. |
GET | /categories.php | Kategorien + Custom-Felder (pk oder sk). |
GET | /kb.php | Veröffentlichte Knowledgebase-Artikel. ?id= für einen Artikel. |
GET | /meta.php | Statuses, Prioritäten, aktive Module, Turnstile-Sitekey. |
GET / POST | /settings.php | Mail-Einstellungen lesen/setzen (sk only). |
POST | /close-request.php | Schließen anfragen. |
POST | /close-resolve.php | Schließen-Anfrage beantworten. Body: ticket_id, accept. |
POST | /upload.php | Datei-Upload (multipart). Max 5 MB. jpg, png, gif, webp, pdf, txt, log, json, csv, zip. |
GET | /file.php?ticket_id=X&file_id=Y | Datei laden. |
GET | /me.php | Tenant-Info + Stats (sk only). |
Beispiel: Ticket erstellen
curl -X POST -H "Authorization: Bearer sk_live_KEY" \
-F "name=Max" -F "email=max@example.com" \
-F "subject=Hilfe" -F "message=Mein Problem ..." \
"https://www.theredstonee.de/api/tickets/v1/create.php"
Management-API (CRUD)
Voller Lese-/Schreibzugriff auf alle Portal-Einstellungen über einen Endpoint (sk only). Secrets werden nie zurückgegeben.
# Komplette Konfiguration lesen
curl -H "Authorization: Bearer sk_live_KEY" \
"https://www.theredstonee.de/api/tickets/v1/admin.php?r=all"
# Ressource schreiben (Liste = ersetzt alles)
curl -X POST -H "Authorization: Bearer sk_live_KEY" -H "Content-Type: application/json" \
-d '{"tags":[{"name":"VIP","color":"#ff0000"}]}' \
"https://www.theredstonee.de/api/tickets/v1/admin.php?r=tags"
Ressourcen: all, agents, macros, categories, kb, statuses, priorities, webhooks, blocklists, recurring, escalation, tags, rules, design, mail, business_hours, sla, autoclose, audit, webhook_log, imap, modules.
Listen-Ressourcen werden beim
POST komplett ersetzt — sende immer die vollständige Liste. agents und kb arbeiten per id (upsert/delete einzeln).