2.2.2.2. Upload-Handler

Zusätzlich zu den Aufrufen im JSON-RPC Format unterstützt die RPC Schnittstelle Upload-Endpunkte zum Hochladen von Inhalten. Diese Upload-Endpunkte werden per POST Request aufgerufen. Die Authentifizierung findet wie bei den JSON-RPC Aufrufen über den "Authorization" HTTP Header statt (Basic Auth).

Ein Upload-Aufruf ist dementsprechend wie folgt aufgebaut:

URL:

https://<Hostname/IP>:<Port>/json/<Endpunkt><ID>?<Parameter>

Hierbei werden der Endpunkt und die ID direkt hintereinander geschrieben, ohne Trennzeichen.

Beispiel: Einen Anhang zum Element mit der ID 234 hochladen:

URL:

https://meinserver:443/json/ItemNewAttachment234

Endpunkte

Folgende Endpunkte werden unterstützt:

DataExchange

Lädt einen Import hoch. Die ID ist die ID des Imports.

ItemNewAttachment

Fügt einen neuen Anhang zu einem Element hinzu. Die ID ist die Element-ID zu der ein neuer Anhang hochgeladen werden soll.

Standardmäßig werden hochgeladene Attachments, falls möglich, konvertiert:

Wird eine .dif, .jpg, .jpeg, .pdf, .tif oder .tiff Datei als Attachment zu einem Brief- oder Fax-Element hochgeladen, so wird daraus der (grafische) Brief- bzw. Faxinhalt übernommen.
Wird eine .eml Datei als Attachment zu einem E-Mail-Element hochgeladen, so wird der E-Mail Inhalt (und Betreff, Datum usw.) aus der Datei übernommen.
Wird eine .ics Datei als Attachment zu einem Termin-Element hochgeladen, so werden die Termindaten aus der Datei übernommen.
Wird eine .vcf Datei als Attachment zu einem Kontakt-Element hochgeladen, so werden die Kontaktdaten aus der Datei übernommen.
Alle anderen Dateitypen und Element-Typen sind davon nicht betroffen und die Datei wird als normales Attachment hinzugefügt.

Um die Konvertierung zu unterbinden, und solche Dateien als normale Attachments hochzuladen, kann als Parameter convert=0 angegeben werden, z.B.:

URL:

https://meinserver:443/json/ItemNewAttachment234?convert=0

Der Dateiname kann im Content-Type Header angegeben werden, z.B.:

Quelltext-Beispiel:

Content-Type: image/png; name="test.png"

Achtung: zwischen dem Semikolon und der "name" Angabe muss ein Leerzeichen stehen, sonst wird der Name im Content-Type nicht korrekt erkannt.

Zusätzlich kann über den Query-parameter created das Erstellungsdatum des Anhangs festgelegt werden. Das Datum muss im Format yyyy-mm-dd hh:nn:ss angegeben und URL-codiert werden, z.B.:

URL:

https://meinserver:443/json/ItemNewAttachment234?created=2021-07-01%2011%3A15%3A42

ItemReplaceAttachment

Ersetzt einen Anhang. Die ID ist die ID des Anhangs, der ersetzt werden soll. Beim Ersetzen von Anhängen findet (im Gegenzug zur Funktion ItemNewAttachment) keine Konvertierung statt.