Come eseguire un upload di un file tramite API

Per eseguire l'upload di un documento tramite le API è necessario eseguire la procedura in più passaggi:

Prima di tutto è necessario eseguire l'upload di uno o più file tramite l'API /api/latest/upload/uploadfile eseguendo un POST di tipo form-data con il parametro "file" contenente il binario

curl --location 'https://app.crmincloud.it/api/latest/Upload/UploadFile' \
--header 'apikey: **************************' \
--form 'file=@"/pathtofile/dueruote.jpg"'

e salvare la risposta dell'upload

{
    "fileGuid": "01234567-89ab-cdef-0123-456789abcdef",
    "fileName": "dueruote.jpg"
}

quest'operazione esegue solamente il caricamento nel server, non registra il file nel CRM

è possibile eseguire il caricamento di più file e poi eseguire un salvataggio massivo delle informazioni sul CRM tramite l'API /api/latest/storages/uploadmultiplefiles indicando i file da importare nello storage e su quale cartella (parametro type) salvare il file. Il valore 0 indica la root.

curl --location 'https://app.crmincloud.it/api/latest/Storages/UploadMultipleFiles' \
--header 'apikey: **************************' \
--header 'Content-Type: application/json' \
--data '{
    "attachments":[{"fileGuid":"01234567-89ab-cdef-0123-456789abcdef","fileName":"dueruote.jpg"}],
    "type":0
}'

Se l'upload va a buon fine l'API restituirà l'ID dei file caricati.

[
    1234567
]

A questo punto, se desiderato, è possibile associare il file ad un'anagrafica, tramite l'API /api/latest/Storages/{id}/Reference dove {id} è l'ID del file, crossId indica l'ID dell'anagrafica e crossType il tipo di anagrafica

curl --location 'https://app.crmincloud.it/api/latest/Storages/1234567/Reference' \
--header 'apikey: **************************' \
--header 'Content-Type: application/json' \
--data '{"crossId":{companyId},"crossType":0}'

Aggiornato il: 17/03/2023