Miloslav HubDOWNLOADS

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í

  1. V katalogu vyberete produkt, vydání a variantu odpovídající platformě a architektuře.
  2. Seznámíte se s poznámkami k vydání, požadavky a případnou licencí.
  3. 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.
  4. Po kontrole systém vydá krátce platný odkaz pro jedno stažení. Tento odkaz nesdílejte a nevkládejte do hlášení chyb.
  5. 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 SHA256

Linux

sha256sum ./balicek.zip

macOS

shasum -a 256 ./balicek.zip

Př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.

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/health

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