Instructions for working with data
Rules and recommendations
For developers and experienced users, in order to quickly obtain arrays of open data in machine-readable formats on the Portal of open data of the Republic of Uzbekistan implemented the ability to submit requests via API.
The API is under development and therefore the methods can be changed without warning, but with the subsequent informing of users. To work with the API, you need to get a private key, which is available after registration in the Portal.
After receiving the key, you can use the API. The key must be written at the end of the request in the following form: /?access_token=your key. For example, to get a list of datasets, the full query would look like this: http://data.gov.uz/ru/api/v1/json/dataset?access_key... your API key offers several formats for displaying query results. The following formats are currently supported:
• JSON (he query string uses the lowercase name «json»)
• XML (the query string uses the lowercase name «xml»)
• CSV (the query string uses the lowercase name «csv»)
The API access point is located at the following adress: <____/ru/api>
CURRENTLY IMPLEMENTED THE FOLLOWING TYPES OF QUERIES:
1. The main page API;
2. Open data set:
3. List of open data sets;
4. Version of open data set;
5. List of version of open data set;
6. The structure of the version of the dataset;
7. The contents of the file version of the dataset;
8. List of organizations:
9. Organization;
10. List of the organization's open data sets;
11. List of areas;
12. List of open data sets by spheres.
Additional filtering is possible for some queries. The list of available filters for each set is presented in the query description. Additional filtering is done via GET parameters.
For example, you can apply additional filtering to a request for a list of open data sets "/ru/api/v1/json/dataset". In order to get all the sets in the sphere of "Economy" you need to use the filter "sphere" with the value "5", which is the identification number of this sphere. Then the final query will look like this: "/ru/api/v1/json/sphere/5". All identification numbers can be obtained through the query "/ru/api/v1/json/sphere". If you use the filter "organization" with a value such as "1", which is the identification number of the Ministry of justice of the Republic of Uzbekistan, the final request will look like this: «/api/v1/json/organization/1/dataset».
PURPOSE AND STRUCTURE OF QUERIES
• The API Request home page is designed to provide information about the API, including reference information, terms of use, and a list of possible requests.
The query structure:
The querystructure: «/
• Open data set - the query is used to get a set of open data. The query structure:«/
• List of open data set versions - the query is used to get a list of open data set versions. The query structure:
«/
• Open dataset version - the Query is designed to get complete information about the version of the open dataset. The query structure:
«/
• Open data set version structure - the Query is designed to obtain complete information about the open data set version structure. The query structure:
«/
• The contents of the file version of the dataset Query is designed to retrieve the contents of the file version of the dataset. The query structure:
«/
• List of organizations - the Request is intended to obtain a list of organizations registered on the portal that provide open data. The query structure:
«/
• Organization - the Request is intended to obtain the full data of the organization providing open data. The query structure:
«/
• List of open data sets of the organization - the Query is intended to obtain a list of open data sets. The query structure:
«/
• List of thematic headings - the Request is intended to obtain a list of thematic headings of open data sets. The query structure:
«/
• Thematic category - the Request is intended to obtain a thematic category. The query structure: «/
• List of open data sets by thematic category - the Request is intended to obtain a list of open data sets by thematic category. The query structure:
«/
