====== URI (Uniform Resource Identifier) ======

**URI** (Jednotný identifikátor prostředku) je kompaktní řetězec znaků používaný k jednoznačné identifikaci abstraktního nebo fyzického zdroje v rámci sítě. V naší **[[ZIF|digitální architektuře]]** slouží URI jako společný technický základ pro adresaci webových stránek, souborů, API endpointů i unikátních objektů v databázích.

===== Vztah mezi URI, URL a URN =====
[cite_start]URI je nadřazená kategorie, která se dělí na dvě hlavní formy[cite: 8]:
  * **[[URL]] (Uniform Resource Locator):** Identifikuje zdroj prostřednictvím jeho **umístění** a mechanismu přístupu (např. `https://www.google.com`).
  * **[[URN]] (Uniform Resource Name):** Identifikuje zdroj jeho **jménem** v konkrétním jmenném prostoru, nezávisle na jeho aktuální poloze (např. `urn:isbn:0451450523`).


===== Využití URI v našich systémech =====

==== 1. API a integrace ====
Náš **[[Vývojový tým]]** využívá URI pro definici RESTful rozhraní v rámci **[[VPC]]**. [cite_start]Každý zdroj (např. uživatel, dokument, projekt v **[[Jira]]**) má své unikátní URI, přes které s ním ostatní služby komunikují[cite: 8].
  * Příklad: `https://api.firma.cz/v1/projects/123`

==== 2. Digitální identifikátory v knihovních systémech ====
[cite_start]V rámci projektů jako **Obálky knih** využíváme specifické typy URI (např. UUID) k dotazování na metadata a digitalizované dokumenty v systému Kramerius[cite: 8]. 
  * [cite_start]Identifikátor může být jedna hodnota nebo pole hodnot, což je klíčové při práci s dokumenty obsahujícími více identifikátorů, jako je ISBN[cite: 8].
  * [cite_start]Příklad URI v API dotazu: `http://cache.obalkyknih.cz/api/books?uuid=uuid:5954939e-dde2-11e0-8e1a-001c259520c6`[cite: 8].

==== 3. Sémantický web a metadata ====
URI jsou základem pro propojování dat (Linked Data). [cite_start]Naše **[[Marketingové oddělení]]** a analytici používají URI k jednoznačnému označení entit v grafech metadat, což umožňuje efektivní fulltextové vyhledávání a automatizované zpracování obsahu[cite: 8].

===== Bezpečnost a správa URI =====
V rámci **[[Kybernetická bezpečnost|kybernetické bezpečnosti]]** a správy sítě (**[[IT Podpora]]**) platí:
  * [cite_start]**Normalizace:** Všechna URI v našich aplikacích musí být validována podle standardu RFC 3986, aby se předešlo chybám v kódování (např. s **[[UTF]]-8** znaky)[cite: 8].
  * **Persistence:** URI kritických zdrojů v **[[ZIF]]** by měla být navržena tak, aby zůstala funkční i po migraci na nové **[[VPS]]** nebo cloudové platformy.
  * [cite_start]**Validace refereru:** Pro přístup k některým API (např. náhledy obálek) je vyžadována registrace URL adresy (referer), kde se budou data zobrazovat[cite: 8].

> **Tip pro správce:** Při konfiguraci našich **[[WWW]]** serverů dbejte na správné přesměrování (301 Redirect), aby stará URI nezpůsobovala chyby 404 a neztrácela se tak kontinuita odkazů v naší dokumentaci.

---
**Související stránky:** [[ZIF]], [[URL]], [[URN]], [[VPC]], [[Jira]], [[Kybernetická bezpečnost]], [[IT Podpora]], [[WWW]]