Invalid documentsData from databases in the XML format is intended mainly for programmers who want to incorporate search results into their own programs, for example for automated verification of numbers entered in forms, etc. This format allows simpler and more definite presentation of data than traditional methods. The program does not have to be revised when the application's graphic design is changed.
Queries have to be sent to http://www.mvcr.cz/vozidla/doklady/doklady.php using the GET method (queries are part of the URL address). Queries must contain the following items:
| Item | Description |
| dotaz | Contains the entire document number. If applicable, the series code can be inserted before or after the number. Not case-sensitive. The program ignores spaces, hyphens, and other similar characters. |
| doklad | Contains the entire document number. If applicable, the series code can be inserted before or after the number. Not case-sensitive. The program ignores spaces, hyphens, and other similar characters. |
| xml | Determines whether the results are shown in a format suitable for being read by a person or intended to be used by a computer program. In the case of no stated value, an empty string, the value “0” (zero), or “off”, the results will be in the html format (suitable for being read by a person). The values “1” (one) and “on” mean that the results will be in the XML format which is suitable for processing by computer programs. |
<?xml version="1.0" ?>
<doklady_neplatne posl_zmena="day.month.year" pristi_zmeny="brief notice (Czech)">
<dotaz typ="document type" cislo="document number" serie="document series code"/>
<odpoved aktualizovano="day.month.year" evidovano="ano/ne (yes/no)"/>
</doklady_neplatne>
| Item | Description |
| posl_zmena | Date of last change in the program (not data) in the “day.month.year” format. The month value is a number from 1 (January) to 12 (December). Spaces can but do not have to be used before and after dots. |
| pristi_zmeny | A very short notice of any future change in the program (Czech). |
| typ | Document type. The values “OP” and “OPs” are used for identification cards with (older type) and without (newer) a series code, respectively. Centrally issued passports (purple) are marked “CD”, regionally issued passports (green) are marked “CDr”. |
| cislo | Document number (without a series code) |
| serie | Document series code, if applicable. If no series code is used for the given document type, the series code attribute will be assigned a hyphen (series serie="-") |
| aktualizovano | Date of last update of the list of documents (the applicable type). The date is in the “day.month.year” format, where the month value is a number from 1 (January) to 12 (December). Spaces can but do not have to be used before and after dots. |
| evidovano | Determines whether the requested document was found among invalid documents. It can have the value “ano” (“yes” - document was found in the database of invalid documents) or “ne” (“no” - document was not found in the database of invalid documents). |
| Notice: UTF-8 (Unicode) coding is used for any ASCII characters. | |
<?xml version="1.0" ?>
<doklady_neplatne posl_zmena="day.month.year" pristi_zmeny="brief notice (Czech)">
<chyba spatny_dotaz="ano/ne (yes/no)">error description</chyba>
</doklady_neplatne>
| Položka | Popis |
| posl_zmena | Date of last change in the program (not data) in the “day.month.year” format. The month value is a number from 1 (January) to 12 (December). Spaces can but do not have to be used before and after dots. |
| pristi_zmeny | A very short notice of any future change in the program (Czech). |
| spatny_dotaz | Specifies whether the query was entered incorrectly or whether a software error occurred. It can have the value “ano” (“yes” - erroneous query) or “ne” (“no” - correct query). |
| text chyby | Error description in a format readable by persons. |
| Notice: UTF-8 (Unicode) coding is used for any ASCII characters. | |
Flash news RSS
Home
Back
Top
E-mail room