Neplatné doklady ve formátu XMLVýstup z datábázi ve formátu XML je určený hlavně programátorům, kteří chtějí začlenit výsledky vyhledávání do svých vlastních programů (například automatická kontrola dokladu při zápisu čísla do formuláře, apod.). Oproti klasickému zobrazení dat je jednodušší a jednoznačnější. Při změně grafické podoby aplikace není potřeba přepracovávat program.
Dotaz je potřeba odeslat na adresu http://www.mvcr.cz/vozidla/doklady/doklady.php pomocí metody GET (dotaz je součásti url adresy). Dotaz musí obsahovat následující položky:
| Položka | Popis |
| dotaz | Obsahuje celé číslo dokladu. Případná série dokladu je uvedena buď na začátku nebo na konci čísla. Na velikosti písma nezáleží. Mezery, pomlčky a další podobné znaky program ignoruje. |
| doklad | Udává typ dokladu. Pro občanský průkaz se používá 0 (nula). Hodnota 4 znamená centrálně vydávaný cestovní pas, poznáte jej podle fialové barvy. Číslo 5 označuje cestovní pas vydaný okresním úřadem, poznáte jej podle zelené barvy. |
| xml | Určuje, zda se výsledek zobrazí ve formátu vhodného pro člověka nebo pro počítačový program. Pokud není hodnota uvedena, pokud je to prázdný řetězec, nebo pokud má hodnotu „0“ (nula) nebo „off“, pak výsledek bude ve formátu html (vhodný pro člověka). Hodnoty „1“ (jedna) a „on“ určují, že výsledek bude ve formátu XML, který umí dobře zpracovávat počítačové programy. |
<?xml version="1.0" ?>
<doklady_neplatne posl_zmena="den.měsíc.rok" pristi_zmeny="stručné upozornění">
<dotaz typ="typ dokladu" cislo="číslo dokladu" serie="série dokladu"/>
<odpoved aktualizovano="den.měsíc.rok" evidovano="ano/ne"
evidovano_od="den.měsíc.rok" />
</doklady_neplatne>
| Položka | Popis |
|---|---|
| posl_zmena | Datum poslední změny v programu (nikoli v datech) ve formátu „den.měsíc.rok“. Měsíc je číslo od 1 (leden) do 12 (prosinec). Okolo teček mohou a nemusí být mezery. |
| pristi_zmeny | Velmi krátké upozornění na případnou příští známou změnu v programu. |
| typ | Typ dokladu. Hodnota „OP“ se užívá pro občanský průkaz bez označení série (nový typ občanského průkazu). Hodnota „OPs“ označuje občanský průkaz obsahující sérii (starší typ občanského průkazu). Cestovní pas vydávaný centrálně (fialový pas) má označení „CD“. Pro cestovní pas vydávaný regionálně (zelený pas) se užívá „CDr“. Pro případné jiné typy cestovních dokladů je rezervováno označení „CDj“. |
| cislo | Číslo dokladu (bez série). |
| serie | Případná série dokladu. Pokud se pro daný typ dokladu série nepoužívá, pak je atribitu serie přiřazena pomlčka (serie="-"). |
| aktualizovano | Datum poslední aktualizace seznamu dokladů (daného typu). Datum je ve formátu „den.měsíc.rok“, kde měsíc je číslo od 1 (leden) do 12 (prosinec). Okolo teček mohou a nemusí být mezery. |
| evidovano | Určuje, zda požadovaný doklad byl nalezen v evidenci neplatných dokladů. Může nabývat hodnot „ano“ (doklad byl nalezen v evidenci neplatných dokladů) nebo „ne“ (doklad není v evidenci neplatných dokladů). |
| evidovano_od | Datum, od kdy je daný doklad evidován jako neplatný. U řady dokladů tento údaj chybí. Datum je ve stejném formátu jako položka aktualizovano. |
| Upozornění: Pro případné české znaky je použito kódování UTF-8 (Unicode). Další informace k UTF-8 naleznete v příloze. | |
<?xml version="1.0" ?>
<doklady_neplatne posl_zmena="den.měsíc.rok" pristi_zmeny="stručné upozornění">
<chyba spatny_dotaz="ano/ne">text chyby</chyba>
</doklady_neplatne>
| Položka | Popis |
| posl_zmena | Datum poslední změny v programu (nikoli v datech) ve formátu „den.měsíc.rok“. Měsíc je číslo od 1 (leden) do 12 (prosinec). Okolo teček mohou a nemusí být mezery. |
| pristi_zmeny | Velmi krátké upozornění na případnou příští známou změnu v programu. |
| spatny_dotaz | Označuje, zda je jen dotaz položen špatně, nebo zda k chybě došlo přímo v programu. Nabývá hodnot „ano“ nebo „ne“. |
| text chyby | Popis chyby ve tvaru čitelném pro člověka. |
| Upozornění: Pro případné české znaky je použito kódování UTF-8 (Unicode). Další informace k UTF-8 naleznete v příloze. | |
Platnost občanských průkazů se sérii bude ukončena 31. prosince 2005.
bleskové zpravodajství RSS
vyhledávání
home
zpět
top
podatelna