---
title: "Přílohy"
description: "Nahrání souboru k záznamu v mWork365 a jeho pozdější stažení."
url: /cs/api-reference/legacy/prilohy/
---

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

<Endpoint method="POST" path="/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](/cs/api-reference/legacy/pozadavky/pridani-pozadavku/) - 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
<Param name="customerId" type="string(GUID)">
ID zákazníka
</Param>

<Param name="serviceObjectId" type="string(GUID)">
ID zařízení
</Param>

<Param name="orderRequestId" type="string(GUID)">
ID požadavku
</Param>

<Param name="orderId" type="string(GUID)">
ID zakázky
</Param>

<Param name="interventionId" type="string(GUID)">
ID výjezdu

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

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

### Odpověď
<Status code="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](#stažení-přílohy).
</Status>

<Status code="400, 401, atd.">
Více informací o [standardních chybových stavech](/cs/api-reference/legacy/obecne-informace/standardni-chybove-stavy/)
</Status>

## 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.

<Endpoint method="GET" path="{publicUrl}" base="https://app.mwork365.com/main" />

### 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:

```text
/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`:

```text
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.

```bash
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.

:::caution[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ěď

<Status code="200 OK">
Tělem odpovědi je soubor.
</Status>

<Status code="404 Not Found">
Na téhle adrese žádný soubor není.
</Status>

### 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í.