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 Request

Nedan är ett exempel på att ladda upp en originalfaktura till ett befintligt case.

URL: POST /media--upload/6867da7788b9226bb78d716c

Headers:

x-api-key: {your_access_token}
Content-Type: multipart/form-data

Form Data:

file: [binary file data]
domain: "cases"
dotted_path: "original_invoice"

Response Code: 201 Created

Response Body:

{
  "_status": "OK",
  "url": "https://storage.googleapis.com/stage-ada-vcom-api-files/stage/cases/6867da7788b9226bb78d716c-3109930dcb954308b2e028392a6f3c62?Expires=1751640521&GoogleAccessId=stage-ada-vcom-pod-svc%40stage-ada-vcom.iam.gserviceaccount.com&Signature=RI%2FVtRaYgkNpFnzQYRihVz90PrvHjtUuKRXB13AIt0%2FXkoBqJ6ekhenljhf%2BQaCK2hn09IkCxxN%2Bd9nVuV1PwlbjcA8DBkzNlqS2tmk%2FrYif%2BAbOZG9rgYAyBpnD6tXs0i11F832E7R3MsprOMyPFvs8BMvev9iaM7qzLZqNw%2FEAvt076ImTVECp6wyoc%2Fsw8ilpCAvqCGTJcIY%2FqoHLHpI3iU7dED5eSTShXGv05OmcEHM98IdVfmOBoKYWkPg9TewkX9Gse0DG2PXFa%2F9RWFHt1tMiNZYix1dcX9wHwFWvBVuGDp1ZBBULSldSD749vLUjTlPhhtsERsVxVHwfQg%3D%3D"
}

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"