PRŮVODCE DOWNLOADS
Dokumentace
a používání.
Veřejný přehled pro příjemce balíčků, znalostních exportů a vývojáře klientů API.
Aktuální dostupnost
Domovská stránka, tento průvodce a veřejná OpenAPI specifikace jsou dostupné bez přihlášení. Distribuční služby jsou nasazené v uzavřeném režimu: skutečná databáze a integrační přístupy zatím nejsou zapojené.
GET /health potvrzuje běh serveru; GET /ready vrací 503, dokud služba není připravena k distribuci. Stav 200 domovské stránky tedy neznamená, že již lze stahovat.
Jak bude probíhat stažení
- V katalogu vyberete produkt, vydání a variantu odpovídající platformě a architektuře.
- Seznámíte se s poznámkami k vydání, požadavky a případnou licencí.
- U chráněných balíčků systém ověří aktuální identitu a oprávnění. Samotné přihlášení nezaručuje přístup ke všem balíčkům.
- Po kontrole systém vydá krátce platný odkaz pro jedno stažení. Tento odkaz nesdílejte a nevkládejte do hlášení chyb.
- Uložíte soubor a porovnáte jeho SHA-256 s hodnotou konkrétního balíčku.
Přerušené stažení vyžaduje nový odkaz. Částečné stahování pomocí Range není podporované. Toto je popis implementovaného distribučního postupu; jeho produkční zpřístupnění ještě čeká na integrace.
Sdílená znalostní báze RAG/AGENT
Znalostní bázi vytváří samostatný subsystém RAG/AGENT. DOWNLOADS přijímá verzované exporty a distribuuje schválené snapshoty. Není rozhraním pro chat s agentem ani pro vyhledávání v RAG.
Export zahrnuje manifest s původem, verzemi zdrojů, licenčními a distribučními omezeními. Právo číst zdroj v RAG samo o sobě neznamená právo stáhnout jeho export. Přístup ke zdrojům se znovu ověřuje při vydání i uplatnění odkazu. Připojení skutečného producenta, kryptografického podpisu CERT a produkčních oprávnění se ještě dokončuje.
Jak ověřit soubor pomocí SHA-256
Porovnejte celý vypočtený řetězec s hodnotou v metadatech příslušného balíčku. Příklad pro soubor v aktuální složce:
Windows PowerShell
Get-FileHash -LiteralPath './balicek.zip' -Algorithm SHA256Linux
sha256sum ./balicek.zipmacOS
shasum -a 256 ./balicek.zipPři neshodě soubor nepoužívejte a stáhněte novou kopii. Kontrolní součet potvrzuje shodu bajtů; kryptografický podpis a důvěru ve vydavatele řeší samostatný kontrakt CERT.
Formáty dokumentů
Distribuční postup podporuje PDF, textové příručky, Markdown a JSON. Dokumenty se stahují jako soubory; Markdown se na tomto webu nevykresluje. JSON má limit 1 MiB a kontrolu syntaxe, hloubky, složitosti a duplicitních klíčů. YAML zatím není podporovaný.
Kontrola formátu nenahrazuje digitální podpis, nezávislé přezkoumání ani oprávnění ke stažení. Zpřístupnění distribuce nadále závisí na aktuální připravenosti služby uvedené výše.
Veřejné a soukromé API
Stáhnout veřejný kontrakt OpenAPI 3.1. Je to statická dokumentace rozhraní; jeho dostupnost neotevírá distribuční API. Úplný kontrakt v repozitáři navíc obsahuje administrační operace.
GET /v1/products: dostupné produkty a stránkování.GET /v1/products/{product}/releases: vydání produktu.GET /v1/knowledge: znalostní snapshoty dostupné danému příjemci.POST /v1/downloads: vydání jednorázového odkazu pro konkrétnípackage_id.GET /v1/packages/{package_id}/content: uplatnění odkazu a stream souboru.
Server vybírá scope podle operace: downloads.read pro chráněná metadata, downloads.download pro stažení a downloads.admin pro správu. Installation a publisher mají oddělené kontrakty; token z jiné služby není automaticky platným přístupem do DOWNLOADS.
Aktuální nezávislá kontrola serveru:
curl --fail-with-body https://downloads.miloslavhub.cz/healthKlient nesmí logovat tokeny, autorizaci ani jednorázovou URL. Technické příklady, DTO, privátní operace a negativní scénáře jsou v repozitáři.
Potíže a chybové stavy
- 401 — přístup nebyl ověřen
- Chybějící, expirovaný nebo odvolaný důkaz identity. Obnovte přístup řádným přihlašovacím postupem.
- 403 / 404 — balíček není dostupný
- Nemáte potřebné oprávnění, balíček není publikovaný nebo neexistuje. Chráněná metadata se neoprávněnému příjemci neodhalují.
- 404 — odkaz již nelze použít
- Stejná bezpečná odpověď se používá pro neplatný, použitý, expirovaný nebo cizí token. Vraťte se ke konkrétnímu balíčku a požádejte o nový odkaz.
- 416 — nepodporovaný rozsah
- Stahujte celý soubor; neposílejte hlavičku Range.
- 429 — příliš mnoho požadavků
- Respektujte hlavičku Retry-After a neopakujte požadavky v rychlé smyčce.
- 503 — služba není připravena
- V aktuálním uzavřeném režimu jde o očekávaný stav katalogu a distribuce. Není to důkaz chybných přihlašovacích údajů.
Při hlášení problému uveďte čas, operaci a identifikátor požadavku X-Request-ID. Nepřikládejte hesla, tokeny, osobní exporty ani aktivní odkaz ke stažení.
Další informace
Podrobné veřejné návody a technická dokumentace jsou soustředěny v dokumentačním portálu MiloslavHub. Rozsah dostupné dokumentace se řídí oprávněním uživatele.
Autorství a podmínky použití
© 2026 Miloslav Hub. Práva k vlastnímu obsahu, dokumentaci a grafice jsou vyhrazena v rozsahu práv náležejících jejich nositeli. Tento web neposkytuje obecnou licenci k dalšímu šíření nebo úpravám. Zákonná užití a samostatně udělená oprávnění tím nejsou dotčena.
Logo a název Miloslav Hub označují tuto službu; jejich použití nesmí vyvolávat nepravdivý dojem spolupráce nebo podpory. Balíčky a znalostní zdroje mají vlastní licence a práva svých autorů. Oprávnění ke stažení není obecnou licencí k jejich zveřejnění. Pro další použití vlastních materiálů se obraťte na autora přes hlavní web Miloslav Hub.
