Ticket aktualisieren

Ermöglicht die Änderung von Ticketinformationen.

Anfragemethode

PUT

Anfrage-URL

https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id

Authentifizierung

Weitere Informationen zur Authentifizierung finden Sie in der Beschreibung unter API-Übersicht.

Anfrage

Beispielanfrage

curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \ -H 'Content-Type: application/json' \ -H 'Authorization: Basic base64(api_key:api_secret)' \ -d '{ "title": "Papierstau im Drucker, Drucken nicht möglich (Aktualisiert)", "description": "Kund:in meldet A4-Papierstau am Ausgabefach, dringende Bearbeitung erforderlich.\nTechniker:in wurde entsendet.", "attachments": [ { "file_url": "https://example.com/files/error-photo.jpg" } ], "priority": "normal", "ticket_type": "incident", "custom_fields": { "department": "IT-Support", "device_sn": "PRN-2024-001", "location": "Beijing HQ, Druckraum, 3. Etage", "resolution_note": "Papierzufuhrmechanismus ersetzt" }, "tags": ["Drucker", "Hardware", "Problem gelöst"] }'

              
              curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
  "title": "Papierstau im Drucker, Drucken nicht möglich (Aktualisiert)",
  "description": "Kund:in meldet A4-Papierstau am Ausgabefach, dringende Bearbeitung erforderlich.\nTechniker:in wurde entsendet.",
  "attachments": [
    {
      "file_url": "https://example.com/files/error-photo.jpg"
    }
  ],
  "priority": "normal",
  "ticket_type": "incident",
  "custom_fields": {
    "department": "IT-Support",
    "device_sn": "PRN-2024-001",
    "location": "Beijing HQ, Druckraum, 3. Etage",
    "resolution_note": "Papierzufuhrmechanismus ersetzt"
  },
  "tags": ["Drucker", "Hardware", "Problem gelöst"]
}'

Diesen Codeblock im schwebenden Fenster anzeigen

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	string	Verwenden Sie `Authorization: Basic base64(API Key:API Secret)` zur Authentifizierung. Den API Key und das API Secret erhalten Sie auf der API-Key-Seite. Verbinden Sie beide mit einem Doppelpunkt und kodieren Sie sie anschließend mit Base64.
Content-Type	application/json	Datentyp, Wert ist application/json.

Pfadparameter

Feld	Typ	Erforderlich	Beschreibung
ticket_id	String	Ja	Ticket-ID.

Body-Parameter

Feld	Typ	Erforderlich	Beschreibung
title	String	Ja	Titel des Tickets.
description	String	Ja	Detaillierte Ticketbeschreibung (unterstützt Markdown).
attachments	Array	Nein	Liste der Ticket-Anhänge. file_url: Datei-URL.
priority	String	Nein	Priorität: low/medium/high/urgent. Standardwert ist medium, falls nicht angegeben.
ticket_type	String	Nein	Tickettyp: incident/question/problem/task.
custom_fields	Object	Nein	Benutzerdefinierte Felder (z. B. Gerätenummer, Bestellnummer usw.).
tags	Array	Nein	Ticket-Tags.

Antwortbeispiel

Erfolgreiche Antwort

{ "code": 0, "message": "Erfolgreich", "data": { "ticket_id": "tk_20251104_789abc", "updated_at": "2025-11-04T10:30:00+08:00" } }

              
              {
  "code": 0,
  "message": "Erfolgreich",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "updated_at": "2025-11-04T10:30:00+08:00"
  }
}

Diesen Codeblock im schwebenden Fenster anzeigen

Antwortparameter

Feld	Typ	Erforderlich	Beschreibung
ticket_id	String	Nein	Ticket-ID.
updated_at	String	Nein	Zeitpunkt der Aktualisierung.