Stažení všeho v ZIPu

Ze stránky detailu sběru podkladů v dashboardu, nebo přes GET /v1/intakes/:id/download, stáhněte vše, co klient odevzdal, jako jeden ZIP soubor — bez nutnosti otevírat každou položku zvlášť.

Co je v ZIPu

podklady-bella-napoli-website-in_8f3kQmR2.zip
├── podklady.pdf
├── podklady.md
├── Logo/
│   └── bella-napoli-logo.png
└── Food and interior photos/
    ├── photo-1.jpg
    ├── photo-2.jpg
    └── photo-3.jpg

podklady.pdf je čitelný přehled každé položky — štítek, typ, stav, odevzdaná hodnota, rozhodnutí i prominuté položky s důvodem — pro člověka, který chce jeden dokument místo otevírání dashboardu. podklady.md nese stejný obsah v Markdownu, pro skript nebo dalšího agenta ke zpracování. Každý nahraný soubor je ve své vlastní podsložce podle položky, přesně tak, jak ho klient odevzdal — žádné převzorkování, žádná změna formátu.

Soubor, který ještě prochází antivirovou kontrolou, se do ZIPu nedostane a uvede se jako čekající v podklady.pdf i podklady.md — po vyčištění kontroly stáhněte znovu. Dashboard na to upozorní ještě před stažením: pokud kontrola u některého souboru stále běží, zeptá se, jestli se chcete za pár minut vrátit pro kompletní ZIP, nebo stáhnout hned bez těchto souborů.

Zahrnutí přístupů je volitelné u každého stažení

Ve výchozím stavu se položky typu secret vynechají úplně, takže zůstávají dostupné pro jednorázové odhalení v dashboardu. Zahrnutím do podklady.pdf — nikdy ne do podklady.md, který hodnoty secret nikdy nenese — se odhalí každá dosud neodhalená položka typu secret, a to odhalení je konečné: spotřebuje stejné jednorázové odhalení jako get_intake_results nebo tlačítko Zobrazit v dashboardu, a další stažení bez přístupů ho nevrátí zpět. Položka odhalená už dřív se zobrazí jako already revealed on <datum> bez ohledu na to, co zvolíte tentokrát. Samotné jednorázové odhalení popisuje Trezor na přístupy. Zahrnout přístupy smí jen vlastní session vlastníka účtu, nebo API klíč se scopem secrets:read nebo admin — kdokoli jiný dostane 403 forbidden (reason secrets_owner_only).

Limit velikosti

Sběr podkladů nad 2 GB se pro stažení ZIPu odmítne (413 download_too_large). Pro tak velký sběr podkladů neexistuje hromadná náhrada — jednotlivé podepsané odkazy na soubory získáte přes get_intake_results / GET /v1/intakes/:id/results.

API

Kontrola před stažením

bash
curl https://api.briefgate.dev/v1/intakes/in_8f3kQmR2/download/preflight \
  -H "Authorization: Bearer bg_live_xxxxx"
json
{
  "files": 6,
  "bytes": 18420531,
  "skipped_files": 1,
  "secrets": { "total": 2, "unrevealed": 1, "already_revealed": 1 },
  "too_large": false,
  "max_bytes": 524288000,
  "filename": "podklady-bella-napoli-website-in_8f3kQmR2.zip"
}

skipped_files je počet nahraných souborů, které ještě čekají na antivirovou kontrolu a do ZIPu se nedostanou. secrets.unrevealed udává, kolik přístupů zůstane dostupných pro jednorázové odhalení, pokud necháte include_secrets vypnuté; secrets.already_revealed se v obou případech zobrazí jako text o dřívějším odhalení. too_large odpovídá tomu, jestli by volání stažení níže vrátilo 413.

Stažení ZIPu

bash
curl "https://api.briefgate.dev/v1/intakes/in_8f3kQmR2/download?include_secrets=false" \
  -H "Authorization: Bearer bg_live_xxxxx" \
  -o podklady.zip

Vrací application/zip s hlavičkou Content-Disposition: attachment; filename="podklady-bella-napoli-website-in_8f3kQmR2.zip". include_secrets je ve výchozím stavu false; nastavením na true se odhalí a do podklady.pdf zahrnou hodnoty přístupů — jen session vlastníka nebo klíč se scopem secrets:read/admin, viz Zahrnutí přístupů je volitelné u každého stažení výše. V obou případech se zaznamená audit event intake.downloaded.

Řešení potíží