File upload

Resource type: uploadfile

Use this API call to upload a file to onOffice. The module and the data record ID specify where the file should be stored. It is possible to upload estate, address and agentslog files as well as files linked to task. This has to be specified in the parameter module.

You also can set tmpUpload as module, then you receive the ID of a cached file with which you can continue to work. See second example for usage.

Uploading files happens in two steps. In the first step you enter the data and the file name, and receive as a response a temporary ID and the file size. In the second step you specify in which module the file is uploaded and with which record it should be linked. The parameter data is needed only in the first step. Do not specify the parameter together with the parameters of the second step, otherwise the second step will not be performed.

A temporary id can only be used once.
Please note that for estate files a document attribute can only be assigned once for every estate. The list of possible document attributes can be edited in the administration.

Some parameters such as “documentAttribute” and “Art” are only relevant for the estate module, these are the additional file information that can be seen on the “Files” tab in the properties module.

Parameters first step:

  • data
    STRING. MANDATORY. File content as base64-encoded binary data

Parameters second step:

  • tmpUploadId
    STRING. MANDATORY. Temporary upload ID
  • relatedRecordId
    INTEGER. MANDATORY. Linked record number
  • Art
    STRING. MANDATORY. Needed for module estate. Type of file.
    Possible picture types: Titelbild, Foto, Foto_gross, Grundriss, Lageplan,Stadtplan, Anzeigen, Epass_Skala, Finanzierungsbeispiel, QR-Code, Logo, Banner, Panorama
    Possible document types: Expose, Dokument, Aushang, Mietaufstellung, Energieausweis
    Possible link types: Link, Ogulo-Link, Film-Link, Objekt-Link
  • file
    STRING. MANDATORY. Filename
  • title
    STRING. Needed for module estate. File title
  • url
    STRING. The URL of the link. Only relevant for the file types Link, Ogulo-Link, Film-Link, Objekt-Link. See below for an example with link.
    Note: The first step (uploading data) is not necessary and “file” and “tmpUploadId” are not mandatory parameters.
  • freetext
    STRING. Needed for module estate. Free text
  • documentAttribute
    STRING. Needed for module estate. Document attribute. The document attributes can be queried by calling Field configuration with module file. The document attributes defined in enterprise can be read and edited under “Administration >> Singleselect: Module: Files, Key field: Document features” under Field. Each document attribute can only be assigned once per estate.
  • module
    STRING. MANDATORY. Possible values: estate, address, agentsLog, task or tmpUpload
  • position
    INTEGER. Position of the file on the “Files” tab if module estate is set. Position 0 is the first image. Without the position parameter, the image is always set as the last image.
  • setDefaultPublicationRights
    BOOLEAN. MANDATORY. Needed for module estate. True or false. Default: false. Controls when uploading real estate images whether the setting “Activate newly added files” under “Extras >> Settings >> Basic settings >> General” should be considered by the API.

1st example first step: Specify file name and data

...
{
 	"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do",
 	"resourceid": null,
 	"resourcetype": "uploadfile",
 	"identifier": "",
 	"parameters": {
 	 	"data": "iVBORw0KGgoAAAANSUhEUgAACBsAAAAXCAYAAABA1dVrAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAABLZSURBVHhe7Z1bluOqDkB7WplQJnEGUbPprzuTHkxdCQMWAmHsSlJd6b3X8ol56IF4BONUn1+fAAAAAAAAAAAAAAAAAAAAACfgxwYAAAAAAAAAAAAAAAAAAABwCn5sAAAAAAAAAAAAAAAAAAAAAKfgxwYAAAAAAAAAAAAAAAAAAABwCn5sAAAAAAAAAAAAAAAAAAAAAKfYf2zw5+Pz9uv++TsnlT8ft89fv36Zqy3f+f15L3VuH59/cu7Gn8+PW5G/fX60hTvJfqn36/PeGJrovyo3YhCDh/jflEUxfA90zNw0SKXNbYd8/r77GJg+8vFRHSv99tNxY6dcLnTPI9l/9Ljc5s3L2rAKsX49QczTOjHjKbGacSGOXx1Pq218eSwKV2PyHb5mXm3/sr0nztuhT5s9/518iofGVr/7/Z5KfZzss1b57jH4VX7fzXri23FyX6ukePR93+/HlFG/HPDT4w0AAAAA74/sb+VxSPa/2+Ufi2RrvJXdUtUpH1Kn6PH75lCPsx/tnVX3V3yzqJz3T/V//Xlrawv7f4AWeTT+lMf0ltF8yXllPRge0yzI1TLNP1gf6joykrXpCWXt69r4VVZ9sPVO+L3CaO1NNk6uu6v8vgf9fpGjtf3d21cRm3acn/3eHKJxOjvujup5PyVeVwljHfmw2oaLiGqhHmy2h4V6EHk8MNoD8/QDBSPU6FA7w8NRd7iZDi5Leqb/qtyAlRhc8r8tS36sHhD/NLTdpW05Bre7bavEQlax/VBaY2PiK/j4aPrwpeRPJ8VqdODfxuZpDO1/lXb+/TUQ69dztc1PidWMC3H86nh6eRvP8qiYvJBX279s74nztvPpQbYeGVvZT93vd/f9rn6avdS/iItxu3dt+/FwX1tIOo/2Y5lhvxzwyHEBAAAAAPAEmhfv8inb6pqWbbXZY88P/WW7vD9Xyadss+see6bH2k9lgxcgKV/q2S3+Gd8aREa29d1LQdX3Tz9vATwLmVfdi1tdI2RO62Wm9XQ9SizI+XVE036+F1TOriuNbLZv7QxZrXeFv8CHUfxmMf0qzXfJAzha29+9fUoa1258qB+j79vLPGKsSqb3U9t3tS/CWEc+rLbhIr+2v2y6fX78Hh1Orxz66osVIyc9u+txZRESFX9gur/kn+i/KueIYzDxf9UPrSejZQ/jYkx+IHvshRyf+92MIclLh9il/cM+0fjYcfe+8aoM4yAMx46OVfujGPcSKeky8dOxqTqyro801rfL99Vuf2Qnk+oOdCSM3E363vr1t9C1NZPjQ6yfQNdmTxCDWaxSm/06EeiI+iIxi2Og0xK1Ldut7qV6RVexMdI/aUdn58R4jHTpfW730IcvxOS+EnPvl/Xl0O9Rv56M6WHbF8dYly71Jm1fjW3Y1lxm6xaafDdOKoG9xEJbZ34dUvaXYsfOk5pf7kVvKU+2e1vb/s1cWtDF5WxsF+fWlliLYzeeFmnaovqc/53NAbnedD+WiPplR+NdfohQf+zg/dD4DGIylAUAAAAAeDay7ZRtaYNsWet+X7ap+15WtqvyKGD2yC1NXUeoR+/dy45OT64jW/bmueqMb5byYkb1Wbv2hY3ey2POVp51yxY+XcUHjVPJS5fGMde1fqifpU7jr9ozOopetV3bmfXVZxXJr34JQ92ZWqb61FYRAngxdk1Rytz5kLxmvuj41nlksLKhXJ5Pdoj7dcSnEyo3yNe6aY2QTz+/jvLSPMt6S14zn3Uu5nY0ZRHWR3uvRGWrMorcFF/0qvkWlXHxtevlKCaJme5JWerzSYxCe0LXF0K4thck8dbtE1Su1LFo/WZ8Gv3WrySff7BgbRcZrdr5HekzMp7Gn4LWN21K7TW+3PSHCCLTpDNhrCMfJr49AlGd6Q4t7QHqdnWBUFSuOZRUuXygmcv2g9zVg9Zex1B/x1W5jI/BI/x3dtMBa+PXu6DtdLHTtIz4Mm7+yDdN+4MO9zIhoPkRwzvix12lHTv2oF5XkhI3HVPNAb6Zq7Us2RjLe/uRHUm0c+hILlozvhNi/XrCmG+EMThs87i/Ur/snRL3RUrGcQx1WsK22f6b9OWkjX07ejt1zOX7eDwa2c5+O3YeExOnI4h530bjy4LfQxtObtme0Ld9dYwVe9fn7ZGfjZyJ55Bq1700N3S+LPfRQh8cobK5rtra/Ssvu51/B3Hd2GV9+ZXYar1GxvSVLQt1C00bUn+bNizS+dvE2MUlosRDfNhV+f2YYPS3/WJRmypTPoUm3iZfaGMykAUAAAAA+AZku5ufHdoDfqWWeXJd+xKt1jvQY+9l+yzPHW1d2Tancv2s22dJL/tmMXLyCNDs64sdzZetf6XRq/KS9vv1IuvLra7UNklvia1etSMCpd1ar5GRevuzyl4W6haaNqhu2waAF6NzyM+ZhJsvI4bzeiB3tI74+V7QuevrVpydo/lc6oVrRr5v5mZkuzCQL3bCslUZwfaNX0csdY1TVEf2u1trTHtmumdlqrPqUVumbtgHQvMdYXyJ1nbLW7fP1J2hPg/HraBlVYfqK2W23kBmqM/Vq0T5Dm1vjUuW8emiI4x1ZCvKfxCiOiO92x06iqc1YOLJ/hdnBmlRe8Csh4j2wNccWGq6qTtiOxwfHf5uGP0NV+UMwxh80f+E2s4/WDiU/6H42JRY6mcKoMYlp22MFe2rEp9BH9mD/bdkFJOEnXP+cN7Nsxz73/qXi/Lksx3uG3lvw6absomdDlvXy23zoM6dvwVi/XpSm8v8zld1dhKDaax8f9m4mbqzvrD1EjaOE50Wr79i/fNE/k1sRnY0/2HjUfHtfEBMmvSJNs7Sy2Un7NmyxMUx1mB1jvQvxHbW1ohUR743RX873wreF2t/0ZcrfmWa73T9/q/+bTFXv+ff+d5/p7PxZbE9im/f0dya6W7uFSu3QPJF+8/IXNnXKqVd+lnbkNPGx7hfWtIPCMS3tXi3dLIAAAAAAC9GtqSyH80J2cTK9tXssd3LA4vkyaPKfvaiafti4kBPepGhl6sn2+nqj/pW9Z/xzWD1JR3uRY76XMsD1E5xQ2l0in2NQykftTOVuXpNWu9z2+TRY/sLzuyn+lj0hbrdvWLlAF6KGc8dWubGqqVZjyyBnI770TqiNPPUI4qSXL7qXHF2wjkX+FMI6x3IJWydmfzKveLSvk0RNn72vrYtY/XNdM/KdN2zRy427eWqfclr2mlYWdvfun0iZL/rVqm28731uX6nWL8mPiqHbdF80atqZ/jvM5+2MQxjrbaknp339ora8FVEdUZGWXPoOmD4l04qJz29t9ccNM7Khmi5O4Rc0nFVzuFj8Cj/rYz0eP9P7b4B2i4bqxrLP58f6f8TLLHRweNj7PHxEpoD8HckjIkZb10d/8JDy/JnrVvytbqTt+noPtG/INF1oL40DuW2et168d0M/Nwg1k9j4G9lFgMfq2Yt9n1i46RX0Jdep/Nrj+NEp2WgY0Plz/bliXZUyrjLn7VeyRe8rE3PyjJfjkmTPtHGWXq57KS9R4wx4fy8/UJcRqQ6ZS+y6e73JVbHhbZe8Suhtrz+IreV3T4+hv+M/zCuitoe7j+Uq7FVOb3Pn7Ws5Jc6E93heDqD2oh0mrIZ1XfxIdyPzfrFkeSM3UaPkNJFh/PPywIAAAAAvBB5pJDnjZxQZF8q23Szx94P8fXAXra026UvMSZ1D8vKvSIbZ9WZ9s9OTl8o1LMdV6ZUnRNUR/U7X0Wllmn79X854NU07TUynR+aNuXqk5XTy7a70WPSKqf36dOUlXxlqtu1wb+MAXgZMmDlMbcZjxUdqzJuy5i26Phu1iOLl8vp4TqSkcftWJ/F6nJ2pnNO7q294Zrh6w3kOmydmfzKvRKkm/aM0Hq5H+t6kmWrLqFZa3L5UPekTGPn02XtP7PuFWZre8XIv137JrKe4bgV1K+hz6q71LP3maG+Qb2Ez8/pIlvsN30g+LT1NYy15C358GBEdcYfFg7YD8Yt9uBVaPRImYyEvb2Tg9F8OHlOv3BVbkRX5wH+Sw9f+ku0n4a237bTxLL8VWB62WFjrLHpO64bZ//sjw2asePGc0rv4yjF7EP0pMDllxr1LzE1y9mw6aZsZkfvTd9M5bYXF4Pu/V6I9euJYp6YxOCwzTZWgX5vezmOE52WqG3deAr6cuqPIbIjPG48Kk+ISZM+0cZZernsTExHbT87xrRe0NedjsXYej87vwcMZUpbFG9P0yfbesUvRes1eyKxWL/z95i33/vqUxRX20+Zpvx6bA/n1kx3Vzbwc5E9Pk6n9z/C1Av3Y3of9ktLyr9P1hiL2wN3sgAAAAAAr0A2pPL4NdzfyhbV7LHnh/D+RYfKlj1+qEf+I49bQznZSjcvKcolW+hab9W3hNZxtmRLXttdXlio3WJDUTs1Ns6Of8nhyxsfLa6eTye/1A/5VJIdjUdOK6FuwZd1fgK8Ch3bbt5V/DxQct70sdjLyU20jhT8vE6onJlThbouODur81nrDdcMV69Lj1iVX7lXfNoimT6OFl1H0o+fTB0fEx/3yky3K7PrsqJ2S3q1Dyxl/RuOAcM7ty/y29uufjl7Xr7YbOoNZIb6XD2L9cdi7VfbGZ+2dcNYRz5E+Q9CVGekt5rDQvG0fUmuB6Wjw0TN3/9qLv0TqaaFzWGl2mh0ZpLt8aHmVP9VuQgfA+HL/qcyc8CscY0OZX80k0Pw1OYcgybGKuPjpnntgXx04P02NDEp9LHRONSXL35+phi78W7lvQ2bdmWhnaGOva86uWhOfCe+DQli/VR8WxyrMejbPInHNI4znXscQ52WYdvceBr6MFoPJzaHdjLZ7yLXjcfkzx6rrTzrGuh9eEwut/GE3zZ92d6g7tkxNvRromMltkOdrd8dgzopfqa/QnspebWtB34J6sc+NjNqI2XaF/LmfmhrK1N91deCq385tlp3OrcmulPSlZmxEOJ0SIaZBxf2tYptl/XD5M/7xaAyyb+gf7z/Nj2SBQAAAAB4NrLv1IP1aOssW2HZY2/3smWVPfB2P0K2t7se1SuyZVsb6sn26/5X5OWxYts/O1SH9fOMb4rW6ff1u5zqK37U++xfFTP+qr5iv+Lqa0xqHbUlelVtpLemta6km/ZJ2vof6takLxNZnjHgu5DH/31sW4J5EK1HlUButo4065NBffP5mjea/0vz2ck0vgVlNZ2p9hVrR7BlZV3o7Dq9oYzT3aUdaQ21MRDCmMx0H9hVnf47QqokQntC8x1h5IZr+4B3bl/T75nkR9Fv9CVyuujSMVR9tn5Zueheyemkz5dZVHepV3B5vo0+bcd7GGt7b4nyH4SozkiPNIesQjlY3S5zMNjV3V6upHoyWkq1DVNmZYyO1s5+7QvhWP9VuZBBDB7iv/T6nv++B6x6sL4vCCaW0X3CxncUHy239d+QFBMbg+3ax3EhGItK0mFil8acqePjvtwnrZ1mrN/un3dZnXY/txch47K/BGL9ero2e4IYzGJ1/5D227XC6jD5s75IzOIY6LQkfaXOfvm+iPuy2C8+LbbDksom41Gw9tM/UV/Kh3ofEROjs7Ox3sZlv5v0V2Jq6l4cY9fn7aKfNj1sgzDMz7brXsja83UXfJn5FaI+jOqoPbWj5WN747haP/fr9t9/zpcLsVVS2tQfzK1Qd8KUdeMppmnrTOfKvlax7RreH/TL/2w9M2Y1HuqDi5vuBXf/S34gm5MAAAAAAM9CtquyL+2v/Vksv2TQq7xcmFDrymVUJEI9UrHI6BU9F8ijQOOXMtQpN7K97uyrvM9TVIfa1PJq2+hoYqQ+ZD9sW8t1+6+3beuN9CeCdK0vBSpv9SpD3ZladndtA3gx8ojbzd2EG/cr61HCySUkYWVG82HkguLnspXVuaN5RXZlPkdrRjTPO78ko8rLZf2xum9yX9tldU38aWQE7ZtSplfJH5L1jmI7kp/pPirTl/6lbGZvpSxa2zty2du2TzKLbLpEzqoPx62gdoc+O3t2vizPA08ur7Kurv8+82n1taTDWGcbnQ9R/oMQ1QAPQmbY8F9++AJ66F7/MhAAQNG1xrzcAng4jDF4JIwnAAAAAAB4IPqCgeeLzJNfngAcomPwlj6+BX3pqS/ZAeAa9gU+XIcfG8BDeeiPA57w4wUA+IlsfxUb/7UvwFdhjD2E9FLdxtFe/1JMg/H0jPgQcwAAAACAENkWv92lfOQXi6Pyd74K5a9Ly8VzD3w35YW/HZevuPTFSfmhw6ici4trfinlxwaj8ne9nsGT1AIAAAAAAAAAAAAAAAAAAMC7wo8NAAAAAAAAAAAAAAAAAAAA4BT82AAAAAAAAAAAAAAAAAAAAABOwY8NAAAAAAAAAAAAAAAAAAAA4BT82AAAAAAAAAAAAAAAAAAAAABOwY8NAAAAAAAAAAAAAAAAAAAA4BT82AAAAAAAAAAAAAAAAAAAAABO8Pn5f+VM4mb5by50AAAAAElFTkSuQmCC",
 	 	"file": "JPEG_example_JPG_RIP_025.jpg"
 	}
}
...

Response:

  • tmpUploadId
    STRING. Temporary upload id. It is needed for the second step
...
"records": [
 	{
 	 	"id": 0,
 	 	"type": "",
 	 	"elements": {
 	 	 	"filesize": 9407,
 	 	 	"tmpUploadId": "b09f36b0-7bf3-4691-e1c6-7a298f1fd1ed"
 	 	}
 	}
]
...

1st example second step: module, data record to be linked and further information

...
{
 	"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do",
 	"resourceid": null,
 	"resourcetype": "uploadfile",
 	"identifier": "",
 	"parameters": {
 	 	"module": "estate",
 	 	"freetext": "Freitext",
 	 	"tmpUploadId": "b09f36b0-7bf3-4691-e1c6-7a298f1fd1ed",
 	 	"file": "JPEG_example_JPG_RIP_025.jpg",
 	 	"title": "Titel",
 	 	"Art": "Foto",
 	 	"documentAttribute": "document_reservation_list",
 	 	"setDefaultPublicationRights":true,
 	 	"relatedRecordId": 30
 	}
}
...

————

2nd example first step with module tmpUpload: Specify file name and data

Request:

...
{
    "actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do",
    "resourceid": null,
    "identifier": "1",
    "resourcetype": "uploadfile",
    "parameters": {
        "data": "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAS10lEQVR42uWaCXhU5bnH\/zNn9pnMJBmSkEAAIwRZXOgFxYWiuNTdW7CWqnW5UBBBZXFHRQW9tlDB1q0KasWltloXKgheiygCWVgFyQYEs2eS2fflzH3fk8xkEibJhMRbn9vveb7nLHNm5vz+7\/K933eODP8P2\/7LLnvYWVe31FRQUCM3GLYGW1r++JPPP\/8u2bWyf\/XNDnQrmfGzG01q81seQZD5Gxuh12hgnDQp4v7uu5e9VVUPnF1a6klZgOHDh8upyfR6PTT0Qz\/GFo1GYFC5cUqmH5eMEC45x3HuR5GQqAkFg3CFQojs2oWQzQbjxInQnXbat46iomvOLSs73qsASqVSEwqFBtNudm9C\/RhaYT6Gfvi0Yl1WZKSpZdNpCLhDUHs8SHM4cJgEkFdXQyAjZlx44ffOQ4cu\/GlNzbEeBaBmon5eNBrd+K+G6635XPWo\/+ICmPVO6NMy4KqWofGtXGQ2eREgEVzkDU2jRiG8ZQsUdL1h7NjDnpqayRc7HM6eBEinPoUE+KSBYkkUo5DJZNTbdOt5C+nauMKyjr+RJe53+ay7c\/HzHT8S3w0H3Wj95mpkaasJPhORcBCNzQ789x8GYZ5VhzS3G34SwRMIoHHwYAiVlVDT9xRpaeumOZ2zUxKgvqGhW9g4aJdtqvtJRUoCmkwMUYygeeevYJbtQpoxk45F2O0uLHzRgN2VKmTRNct8PmQ5nZIIEfrcLQgI0VYbjYoBtfrMFAVoTALdu\/V73E8Bujurt7UomkoXI933HtJMZvpYDrfLjSfXG7CxSIhfpfT7cZ\/FglHkAdzsCgWaMjORR78nWiwrUw6BZNAnWD\/hRlMB7xG6OyHaP2s5tBq65mdgTDdDUCjhcXvwyqZ0rN0QiV8WDofR2tqKkMuFpwQZxkGOWvYAGh0EEsHocr2bkgCNTU3ozeWTipDCfo\/ekMTyfGSv\/gCyI\/OQkZ4JpVpL8G58unswHl\/rjl\/XFg522GgE0KmjeP1+RLTbFbK6rRE5MZH\/wL1TLr8kRQGak8AnSXhJrJ4qeKoh4G7agdCB6wleD7VWD5\/HjeJjI3D3KrJ0OCpdw4BuEoWtHxXDeH4hxAtOR0SQy1DzkUw48qEYeh345ffA5pQEaGpu7gTdI3AqIvQmSjfnfI5KeIovR4ZRDp3BRPBOHLGOxOwVFjho3I81P8V9S0uLtF12G8QZUxFRELxGI8g0akG867HQPR8cEP+mBLwpCdBMSaQvcd\/XMEgqSpdzIZ8F9h2XIUPngs5oRtDnQpPvVIK3oqaxw\/U57hmePWD21cBd0wlekIlaNcGTAK9uEJ9ati70CuuJ1AVo6Tn++yNC+3Ey6Ni5SNiHlh3XIkNBY70pm8Z+H5yRfMxf5cX+w83xryXG\/RXnRPHMXAGCXIyQ1aPUZf\/YEV0\/d2XwCXaSdgH8KQlgaWnpFT4ZZJ\/Au7M+j\/VFt8IkFhF8LkGG4Itk49HXBGzeVhW\/NBb3bP0JIyP4070CtBo5VIpoRKsRsLdS9s8Zj\/gXBILwtgvAPdBbKfxTFqCFkklS+FRFSHU\/ybFl38PQu\/4GQ+ZQ6bwvbMBLG3Ow7t3iTjfL8W6hUM3LDGD9UgGZRhnUagXUyqh4vFl28Iol\/tucHtgT4LmHUhagT\/A9uH5frG+reBnKhlVIyxwGQVDCF1Jiw94xeOLZzZLFY43Hdc74arkbbz0qx\/AcOcELILeH1RltvPJe\/6ya5mhlF\/hgygK0Wq3984BUROhy7KrdCLFqIYzm4VCotGThCErqz8ddj7yPYLAj43Pcc8wHvHasfUCGs0Z2wCvVJky9o+nJw8dFntBZkggQSVmAVOEHIgx8rXvg\/5bi3pwLldoIP5Wxx7yX4fYl78Dh6Mj47AUuqvJstlasmifikolt4BqVQCKo0WBaidPPn303XbqTenMCPNfF4ZQFsJLCfYE\/AawPIgRcx+HecwNM6enQ6DLI8j60Clfg9sXv4\/vaxk436KOJDie9RdcH8eufdcDztlZzH4JpV2DSpEkL6NIdXQQItgsQTVmAPsGfpAjhoB2O4l\/AaCAIQxZCQS+82ssx75HN2Lu\/rNPNcdwz\/PTzvXjw5g5wjVqORuUtaFXPRFpaGiZMmDCPLv+miwCS9eMcvQnAMdYrbBLQeFWY7FyX\/agYhLXkVqSpbNAacxEO+RHSTcFDz+7Hli92dEp6sbifeKodzy4QoNO0xb2Wk57iMtQoFkhLeAaDAWecccZc+sp26k0J7s\/w0dQFoOKiT\/B9FIHhrPsWQh8toypvKCKRMM1czsSad2x4852P6bhjhheL+yHprVh7PxUrBiGe9DyKn6ACD0Gt0UOr1YLXMseOHTubvvY19cYE64vx\/09FAK6u+gPfmwj2spVQubdAn1HAhAgJ+XhvmwEr1\/xZcvXExnGvkVnwxoMR5A3qgA8qTsGB8OOU+dMl+JgHFBYW3k5f+7LdA4Ix1++bAA7HD+YBruN\/gaxpLQzmUZDLFQiKRnxVMQr3P\/q8BJvYWIywvwWvLPFj9LBYzAuIKrKwJ\/A4oBosgScKUFBQ8Gv66la05YBwzPX7LkCCNQfKAzxNXyJybDnBj4ag1CAYkuOQZSLm3\/scbHZHp5vhMPC6bfj9XBcmj++AF5R6lHqXkgec2gmet5wEhw4dOpP+aytxtCS6fp8EcJAA0s2nKkIS+K5x77cfgv\/wQqQNKoRSlSYVN7X+yZiz+GXU1Td2SnpSne9y4qGZNlx1rhxc2zO8SqXEbvdCOGVnSdCJAnD8m0wmDBo06HqqCbYGAgFrMsjUBHA6k4L2ujrUzTbkrYPnwFyq74dBpaWpbcAHW3Qi7njgbZRXHJOyfCI8h8It01ow6ypImV7DAqjk2O++FQ3hqZ3guet0Osn6RqORt\/9JAnxFAthOWgAnCdCdtfsKHwk64dz3GxiMGVAb8trGevlYLHpiE4pKD3bK+NyCwSAuPqMFD98UInhFfKyv8F5F\/bq4xbnyY3C2PMc+C8D7dP66dgHsJy8ADTupxH1v8DyVde6fT+N2FBrjCBrrAwjKhuDRNcXY\/EWJtJiR2FiM8fmtWDnHB72OwRUkghy1gXOw23YrDXeauPVjSS9m+XZ4mkQJ19L264ET4CRF4ORrP\/gINKiFNmOMtKYfEg14bv1RvP3+NsnSiY1dPy\/djufvciEzTd7m9lzohAuxrWkezRH0neAZmME57mPwCoWCRhZ5\/wXgwiMpaIoicHNV\/QEKz3boBv0HScFL01G8vbEFz726BYH2NftEeJPWgxcWWDE0qwPeF83FppoFkCvTk8Kn0\/yBPYDPkeWlTvfQLwF4RWiDy+1O3dpdPuPmqf2A6rDXoB88BTJBJyW9LbvcWLZqE7xe7wl\/rBICWDPXgjHDEYcX5SZsODYfIXlOJ3iOe4bPyMiQrM\/HbHluZP2BFSCZ1XuLe3\/LdgSrliEt7yIIal7MdKD4kBdLVmyG0+nuNNxJN02F2vJbmnDeOLEt4ZEAgkKDT47MhjMyolt47uwJSqWyLUw7ev8F4LW2pMC9iBB0lsF3cC7ScqdAqR+BgN+K8qNO3PnYF2hpdZ4Az8dLfm7B1ecG48OdWqXAxiMzUe8b3wk+VuhkZmZKnfdVKlXM6vH7GDABerN+V\/iwv5Hm9b9CWvZZUJlOR9BvQ22dBfMe247jdbak8DdPs2HW5d42eEkAObZWX4HD1sndwlOhI7l+e8bvDDdgAng8fQoBMeSGo3QGjfUUr9lTpbG+pekY5j9RjO+qToTndukEF1V6jnb4tsRXWj8ZO2ovTQrPLs\/wvOVzHPddnzq330\/\/BfCQAD2NAonw\/CjKsftmaAQbdHnXICLK4bQcwpLfHcDOfdak8BNO9eG3s1ph0LXDkwgVrafh0\/LraKzXdqrvOc4ZOisrS\/IAHvvbs\/2JAtCxfKAE6C322\/ZprN+\/CCrvV9DnT0dUng63pQRPvFiOjdtdSeFH5ATxxzstMJvkcfh61xD8Zf8NUKj0cfjE+j47Oxtms1nyhMSk19X9GU8Q+lcHtAlAQ1Uq1m+q+BC6+nuQNvRKKtpHwdO8C8+\/VYE3PwsnhTcbw3hhvgXDchCHdwQy8FrxDYgKGSfU+AzPlufO+5z0unH7Nm+U8YOR\/lWCnQTo2fpA1e4NyAytRaY5Bx7Hcbz36VH8\/q9KJGGHViXiuXkWjB8RiY\/1AVGHV3dcD6+YnTTuGZytzwUPJ73YalIyAXg0EOUC9GpV\/wWQipVeMn\/Q78b3h\/4HCn6dzrIepUVf48n1eoTFE\/9CkEfx9G2tmHJ6MA4flSmxdsfVaPYO6wTPneE54eXk5EjwfC4GHxMgto3dFwsQVaiQrtdeS57yNZXa\/ROgtxzQUFlEMR+BGHYj5Lfjm1178PRznyT94SUzbJh+gS8+rxcUcqwvuhiVLYVxaLZwbILD8c6W56TH3iBZl6bMPHniCRO\/wMUC8O3wZ3JKigpBgYhCJeaZ069RKJTfhMMhR7J76ZsAPbr\/R1DrtQRvQ4i8LeSz4fk3vsRXxTWdfvSmaVQIXeOOFzoKhQwf75uEndVnJYXnjB9LepwEufHSGC+ghMIhRMIRSQx+54PvhAXgV2bUxky8\/urLn614\/LGHdTp9mdfr8SWDTE0An69H9w8H\/Sjb9SZ0xrQ2AcgDWASvx4o3\/\/4dtu+xSwtx087y4MlbHDQd7oDfVj4aG7497wR4hmV3jyU9PmYrBwJBafLEs0dpjZC9gGaWHAE05EFJ3zeZB+Hzjf8oWbxo0T0KpbKcSma73WYTB0aABC+IidB4pAQu6yGIEW9cgGCgzROC5AmV1XYcrPRg6cxGmAyC5PoMf6BmCN7YcRGN9bp4pk9c0WGrMzx7Art5IOCHz+eXngTHRAhTCETJA9jyGZkZMA8yo6S4qHLunDtmk2ccNKWn25ubmsTuIFMSQFqd7cH9y3e9S1mIgRPg270gTFWhXK4kt9ThzMF7kWEAFEoZjrea8dK2y6UHmLFVHO6J++wBLAbD8yMyp9MFrkl8JADD8\/MDvocheUMwbFi+dC\/79u9tnjNn7q1Oh7OYBLTX1dWJPTCepAAJ+xGKw31bfge1TtZmcQIPcw4IOqU3O2QysrbaKIEqom6My9qDcFTAul03QK5uy+o8prPFYwJwGPAYz+VtKBSG1+cFL8w2NjRQ3POwqUYm5Ybc3FzkDcmT7sVqtaGs\/LB7\/p0Lbm9oaPjn4MGD7UePHu0Rvk8CdBf\/VYfI\/Ws\/pX0fWd5B8A7p9VUxEoBM3rZsrVAZoVKnw2KN4HiTEsasEdCnD5fgeTrL4Oz6MWiOdU5s7Oputwc8HbdZrbDarLjpxhvjQx57AF\/D8EeOVIbuv\/+BeWVl5R\/m5+fby8rKeoXvuwBJwmDNs6vQVLMbP5+WiUjIRd0jrf2x5QWFlgQwoNUugyOYB9PgM5Cdmx9fs2NotnZiOcvDGic3fiTucjolt+dVaRaAM\/2M6dNPgD96rEpcvnzFgyXFpWsLCk5xHDjwbUrw\/RJAyv7k\/r+4fgbN7W0Yf6oGN145iD6PgF9blQkaeLxUFOlOR07BOcig6pDjOQbMlm5fs4sXNDF4jm+Xi2aUTge5PolA7s\/PJ7kQunjaRV3gj0RXr169\/Mut29YUFo6y7969J5oie98F6BoGJUU7sWjJfdK6Pd\/QqGFqzP3laKQbc5E+dCqyCyZLDypjwDxr67pgwS3m8jykMTz\/Flud495us0v7vDR\/9tmTUDhqZCI8XnrppWc\/27R5xZixY+zFRcV9gu+3AL995im899cP4gJkZ5mx8O4FmHnjzXRRxxQ19j2G7\/Tn7eUsw3OPWZ+HXQe\/7mZ3SFt+NOenczNmTJeqvZjlCX715s82rxg3bpx9585dfYZPXQCCO2HeHxVx6SUXS4+xRhaMwG\/mzMHV11wnWbsrZLL9rgIkuj+vQNkJXnrnjzpbPycnG5PPOTse86tXr1nBbj9u\/Dj7rpOEPzkB2vPAntJivPDiC5j1X7Nw\/pSpSZfC+yoAw8fiP\/bCIwvBwyDDcwhxtl\/x1FNLS0tK144ZQ25fXHLS8P0SIBQK0rCl7hH4ZAXgzB8TgONfR6PF6NGF0ji\/9OGl95SXV\/ydEp5jz569\/YLvlwCpWPxkBZDe\/JIEsEv5YMTwYaiqqmhesnjJnY2NjV+cUlDgOPjtwX7D\/+gESBwC2QPsbH1TBg7vK62697775rucruL8YfmOivKKAYFPWQDO8IkAXdfgeoNMRYDEUYDrfQeFQVChwdaNH5csfeihxXTdQSpvHdXV1QMGn4oA59MffzqQf9i1SQJQD9OEh+v8INUC\/mAYbl9AXPfyC5+venr5MhpZyjPNZkdDff2AwvcoAFnHQDdXSLu54CdW\/\/eNXxSoo\/lBNU1pnZbm5gGH71EAUl2gykxLIgjo2VN+qBalewhotNoAzQl+EPgeBfh3af\/2AvwvbF+OQNe52mMAAAAASUVORK5CYII=",
        "file": "test.png"
    }
}
...

Response:

  • tmpUploadId
    STRING. Temporary upload id. It is needed for the second step
...
"records": [
 	{
 	 	"id": 0,
 	 	"type": "",
 	 	"elements": {
 	 	 	"filesize": 9407,
 	 	 	"tmpUploadId": "b09f36b0-7bf3-4691-e1c6-7a298f1fd1ed"
 	 	}
 	}
]
...

2nd example second step with module tmpUpload: Specify module and further information

Request:

...
{
	"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do",
	"resourceid": null,
	"identifier": "2",
	"resourcetype": "uploadfile",
	"parameters": {
		"file": "test.png",
		"title": "test.png",
		"tmpUploadId": "3e53c275-ea8b-4a32-0d04-6915acf945f6",
		"Art": null,
		"relatedRecordId": null,
		"module": "tmpUpload"
	}
}
...

Response:

  • tmpUploadId
    STRING. Temporary upload id.
  • cacheFileUuid
    STRING. Cache file uuid with which you can continue to work.
...
{
    "status": {
        "code": 200,
        "errorcode": 0,
        "message": "OK"
    },
    "response": {
        "results": [
            {
                "actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do",
                "resourceid": "",
                "resourcetype": "uploadfile",
                "cacheable": false,
                "identifier": "2",
                "data": {
                    "meta": {
                        "cntabsolute": null
                    },
                    "records": [
                        {
                            "id": 0,
                            "type": "",
                            "elements": {
                                "filesize": 4880,
                                "tmpUploadId": "15fe4d69-241f-42c3-f5ac-6a8c39a3bb69",
                                "cacheFileUuid": "ec74c71e-fea4-47dd-8d84-dac7a83d69fd",
                                "success": "success"
                            }
                        }
                    ]
                },
                "status": {
                    "errorcode": 0,
                    "message": "OK"
                }
            }
        ]
    }
}
...

——————————

3rd example: Upload link

Request:

...
    {
        "actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do",
        "resourceid": null,
        "resourcetype": "uploadfile",
        "identifier": "",
        "parameters": {
            "module": "estate",
            "title": "onOffice Webseite",
            "Art": "Link",
            "url": "https:\/\/www.onoffice.de",
            "relatedRecordId": 2651
        }
    }
...