Přílohy

Přílohou může být jakýkoli soubor připojený k zákazníkovi, zařízení, požadavku, zakázce nebo výjezdu. Nahrává se přes API, stahuje se z adresy, kterou si příloha nese s sebou.

Nahrání přílohy

POSThttps://app.mwork365.com/main/publicapi/attachment

Příloha se do mWork365 nahrává běžným způsobem pomocí Content-Type: multipart/form-data takže může být soubor součástí requestu.

Pro nahrání přílohy potřebujete znát interní ID záznamu, se kterým chcete přílohu svázat. Tzn. pokud chcete například vytvořit Požadavek obsahující přílohu, postup je následující:

1. Přidáte požadavek - Server vám v odpovědi pošle jeho ID
2. Nahrajete přílohu a jako query parametr uvedete ID požadavku, ke kterému se má příloha nahrát.

Přílohy jsou podporovány u následujících entit:

• Zákazník
• Zařízení
• Požadavek
• Zakázka a Výjezd (Příloha může být svázána buď jen se zakázkou, nebo může být svázána s některým výjezdem dané zakázky, v takovém případě je potřeba odeslat ID zakázky i ID výjezdu)

Parametry

customerIdstring(GUID)

ID zákazníka

serviceObjectIdstring(GUID)

ID zařízení

orderRequestIdstring(GUID)

ID požadavku

orderIdstring(GUID)

ID zakázky

interventionIdstring(GUID)

ID výjezdu

Upozornění

Je potřeba odeslat alespoň jednu vazbu na nějakou z entit, jinak se příloha nikde nezobrazí.

Upozornění

Každou přílohu můžete svázat pouze s jednou z entit (s výjimkou výjezdu a zakázky)

Odpověď

200 OK

Příloha byla úspěšně nahrána. V těle odpovědi je objekt přílohy — mimo jiné s adresou publicUrl, ze které se soubor stahuje.

400, 401, atd.

Více informací o standardních chybových stavech

Stažení přílohy

Přílohy se nestahují přes publicapi — každá má vlastní přímou adresu souboru, kterou si vyžádáte běžným GET požadavkem.

GEThttps://app.mwork365.com/main{publicUrl}

Kde adresu vzít

Adresu nese pole publicUrl na objektu Attachment. K tomu se dostanete dvěma způsoby:

• hned po nahrání — volání výše vrací v odpovědi celý objekt přílohy;
• z detailu entity — zakázka i požadavek mají pole attachments se seznamem příloh.

publicUrl je vždy relativní cesta, například:

/files/mojefirma/attachment/protokol-2026-09.pdf

Výslednou adresu složíte tak, že před ni dáte kořen aplikace — tedy bez /publicapi:

https://app.mwork365.com/main/files/mojefirma/attachment/protokol-2026-09.pdf

Jak soubor stáhnout

Obyčejné GET. Odpověď je samotný soubor; Content-Type se odvodí z přípony.

curl -O https://app.mwork365.com/main/files/mojefirma/attachment/protokol-2026-09.pdf

V Make.com na to nepotřebujete nic zvláštního: použijte standardní modul HTTP → Download a file, do pole URL vložte složenou adresu a soubor pak předáte dál jako binární přílohu.

S adresou zacházejte jako s citlivým údajem

Tenhle požadavek se neautorizuje — přístupový token do něj neposíláte a soubor dostane kdokoli, kdo adresu zná. Nevystavujte ji tedy veřejně a nepředávejte ji nikomu, kdo by k danému záznamu neměl mít přístup.

Odpověď

200 OK

Tělem odpovědi je soubor.

404 Not Found

Na téhle adrese žádný soubor není.

Kontrola staženého souboru

Objekt Attachment nese vedle adresy i sizeBytes a md5Hash. Podle nich se dá po stažení ověřit, že soubor dorazil celý a nepoškozený — u větších příloh se to vyplatí.