Neue API-Version v7.8.64 wurde veröffentlicht! 🎉
REST Dokumentation
POST Anhang hochladen

Ticket-Anhang hochladen

Mit diesem Endpunkt können Sie einen Anhang zu einem Ticket hochladen.

Request

POST /api/v1/tickets/:ticket/attachments
curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets/123/attachments' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "filename": "dokument.pdf",
  "file_contents": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoKMiAwIG9iago8PC9UeXBlL1BhZ2VzL0NvdW50IDEvS2lkc1szIDAgUl0+PgplbmRvYmoKMyAwIG9iago8PC9UeXBlL1BhZ2UvTWVkaWFCb3hbMCAwIDYxMiA3OTJdL1BhcmVudCAyIDAgUi9SZXNvdXJjZXM8PD4+Pj4KZW5kb2JqCnhyZWYKMCA0CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDYyIDAwMDAwIG4gCjAwMDAwMDAxMTUgMDAwMDAgbiAKdHJhaWxlcgo8PC9TaXplIDQvUm9vdCAxIDAgUj4+CnN0YXJ0eHJlZgoxOTYKJSVFT0Y="
}'

Parameter

  • ticket (integer, erforderlich): Die ID des Tickets

Pflichtfelder

  • filename (string): Der Name der hochzuladenden Datei
  • file_contents (string): Base64-kodierter Dateiinhalt

Response

Erfolgreiches Hochladen

{
	"success": true
}

Das erfolgreiche Hochladen gibt ein Objekt mit success: true zurück.

Fehlercodes

  • 401 Unauthorized: Ungültige oder fehlende Authentifizierung
  • 404 Not Found: Ticket mit der angegebenen ID wurde nicht gefunden
  • 500 Internal Server Error: Hochladen fehlgeschlagen

Hinweise

  • Die Datei muss als Base64-String kodiert sein
  • Stellen Sie sicher, dass die Dateigröße innerhalb der zulässigen Grenzen liegt
  • Unterstützte Dateiformate können je nach Systemkonfiguration variieren
  • Der Dateiname sollte die korrekte Dateierweiterung enthalten

Beispiel

Um eine Datei hochzuladen, müssen Sie den Dateiinhalt zunächst in Base64 kodieren:

# Beispiel für Base64-Kodierung in der Kommandozeile
base64 dokument.pdf

Dann verwenden Sie den kodierten String im Request:

POST /api/v1/tickets/123/attachments

Request Body:

{
	"filename": "dokument.pdf",
	"file_contents": "JVBERi0xLjQKJeLjz9MK..."
}

Response:

{
	"success": true
}