Invalid documents in XML format on file Czech Republic
Data 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.
Query format:
Queries have to be sent to http://aplikace.mvcr.cz/neplatne-doklady/Doklady.aspx 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. |
For example, http://aplikace.mvcr.cz/neplatne-doklady/doklady.aspx?dotaz=123456AB&doklad=0 is a query about an identification card number 123456 series code AB. You can view the results by clicking on the link if you have MS Internet Explorer 5 or higher. In the Mozilla browser, you have to enter the command Show Source after clicking on the link.
Reply format (if no error occurs)
<?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. | |
Reply format (if an error occurs)
<?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. | |
Format of document numbers
- Identification cards without series code (newer type)
The document number consists of nine digits. The first digit may not be a zero. The document has no series code. - Identification cards with series code (older type)
The document number consists of six digits. The first digit may be a zero. The document has a series code that consists of two letters (no diacritical marks). Some identification cards may have a series code consisting of two letters and two digits (such as AB01). Not case-sensitive. - Centrally issued passports (purple)
The document number consists of eight digits. The first digit may not be a zero. The document has no series code. All centrally issued passports have different numbers. Some passports issued centrally and regionally may have the same number. - Regionally issued passports (green)
The document number consists of seven or eight digits. If the document number consists of eight digits, the first digit may not be a zero. Seven-digit numbers may begin with a zero. The document has no series code. All centrally issued passports have different numbers. Some passports issued centrally and regionally may have the same number.
Known future changes
Identification cards with a series code will expire on December 31, 2005.