Romania-UAT-API
The project is a web API for the administrative units on the Romanian territory.
Other linked materials
Usage
The API is free to use and it can be found at https://romania-uat-api.herokuapp.com/
To access the documentation, navigate to /documentation.
Rate limit
The current rate limit is set to 200 requests per IP in a 5m window.
The following headers can be tracked to monitor the usage, if needed.
x-ratelimit-limit- total number of available requests in the defined time period;x-ratelimit-remaining- the number of requests remained until the reset time;x-ratelimit-reset- the timestamp in seconds when the usage limit will be reset;
Example usage
The /api/v1/uat endpoint can be used for all the required operations.
This endpoint can query the dataset based on a given SIRUTA code or based on the UAT type.
Example 1
Get information about Brasov.
https://romania-uat-api.herokuapp.com/api/v1/uat?siruta=83
[
{
"label": "BRASOV",
"type": 1,
"siruta": 83,
"mnemonic": "BV",
"sirutaUp": 877
}
]Example 2
Get all the UATs from within Brasov.
https://romania-uat-api.herokuapp.com/api/v1/uat?sirutaUp=83
[
{
"label": "HOLBAV",
"type": 5,
"siruta": 42472,
"sirutaUp": 83
},
{
"label": "MUNICIPIUL BRASOV",
"type": 3,
"siruta": 40198,
"sirutaUp": 83
},
{
"label": "MUNICIPIUL CODLEA",
"type": 3,
"siruta": 40241,
"sirutaUp": 83
},
...
...
...
]Example 3
Get all the UATs that are of type JUDET.
https://romania-uat-api.herokuapp.com/api/v1/uat?type=1
[
{
"label": "ALBA",
"type": 1,
"siruta": 10,
"mnemonic": "AB",
"sirutaUp": 877
},
{
"label": "ARAD",
"type": 1,
"siruta": 29,
"mnemonic": "AR",
"sirutaUp": 859
},
{
"label": "ARGES",
"type": 1,
"siruta": 38,
"mnemonic": "AG",
"sirutaUp": 831
},
...
...
...
]Contributing
Pull requests and stars are always welcome. Please check the guidelines.
Stay in touch
Author - Stan Georgian
Discussions - Discussions Page
License
This project is licensed under the MIT License.