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:
1
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:
1
https://meinserver:443/json/ItemNewAttachment234

Perma LinkEndpunkte

Folgende Endpunkte werden unterstützt:

Perma LinkDataExchange

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

Perma LinkItemNewAttachment

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:
1
https://meinserver:443/json/ItemNewAttachment234?convert=0
Der Dateiname kann im Content-Type Header angegeben werden, z.B.:
Quelltext-Beispiel:
1
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:
1
https://meinserver:443/json/ItemNewAttachment234?created=2021-07-01%2011%3A15%3A42

Perma LinkItemReplaceAttachment

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.