Media Upload
Ladda upp filer till Amili-systemet. Denna endpoint används för att bifoga filer till olika resurser, såsom originalfakturor till cases.
Media Upload endpoints
POST /media--upload/{reference_id}- Ladda upp en fil
Se Case Registration för att skapa cases.
Exempel
För kodexempel inklusive arbetsflöden för mediauppladdning, se Ärendeflödesexempel.
För komplett API-specifikation med interaktiv testning, se Swagger: Media Upload.
Parametrar
Path Parameters
| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
reference_id | string | Ja | ID för resursen att bifoga filen till |
Form Data Parameters
| Property | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
file | binary | Ja | Fil att ladda upp. Standard tillåtna typer: PDF, JPEG, PNG, GIF, BMP. Specifika fält kan ha olika restriktioner. |
domain | string | Nej | Resurstyp (t.ex. "cases", "invoices"). Standard är "media--files" om inte angivet.* |
dotted_path | string | Ja** | Sökväg till fältet där filen ska lagras (t.ex. "original_invoice" för cases). Obligatorisk när domain inte är "media--files".* |
Response Properties
| Property | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
_status | string | Ja | Request-status. "OK" vid framgång, "ERR" vid fel. |
url | string | Ja | Temporär signerad URL (giltig i 1 timme) för att komma åt den uppladdade filen |
Error Responses
| Statuskod | Felmeddelande | Beskrivning |
|---|---|---|
| 400 | "Domain '{domain}' is not valid." | Den angivna domänen är inte registrerad i systemet |
| 400 | "Dotted Path Not Found in request form" | Parametern dotted_path är obligatorisk när domain inte är "media--files" |
| 400 | "Dotted Path is not valid" | Den angivna dotted_path existerar inte i domänens schema eller är inte ett mediafil-fält |
| 400 | "File is a required attribute." | Ingen fil angavs i requesten |
| 400 | "The provided file's content type is not allowed." | Filtypen är inte tillåten för detta fält. Felmeddelandet inkluderar förväntade och faktiska innehållstyper |
| 404 | "Resource Document Not Found" | Resursen med det angivna reference_id existerar inte |
*) För komplett lista över giltiga domäner och dotted paths, se Media Upload **) Obligatorisk när domain inte är "media--files"