- Prepare the
config.cfg
based on the provided template file:cp config-template.cfg config.cfg
- Open the newly created config.cfg file with your favourite Terminal-based text editor:
nano config.cfg
- Fill in all the config value.
- Install the app:
bash install.sh
- Run the app:
bash run.sh
bash run-debug.sh
Municipality Procurement API
This is the API of e-prokurimi platform that visualizes procurement data from local municipality and automatically detects irregularities through a contextual and custom built red flagging algorithm.
URL
http://e-prokurimi.org/api/municipality-procurements/
Allowed HTTPs requests
GET
JSON structure
Sample JSON body structure:
{
"_id" : ObjectId("59f6e4a6e4f9620441c65915"),
"viti" : 2012,
"tipiBugjetit" : "Të hyra vetanake",
"klasifikimiFPP" : 30,
"tipi" : "Shërbime",
"kontrata" : {
"qmimi" : 500,
"vlera" : 500,
"afatiKohor" : "Afati kohor normal",
"kriteret" : "Çmimi më i ulët",
"qmimiAneks" : 0
},
"kompania" : {
"tipi" : "OE Vendor",
"emri" : "Lorem Ipsum",
"slug" : "lorem-ipsum",
"selia" : {
"emri" : "Prishtina",
"kordinatat" : {
"gjeresi" : 42.6662068,
"gjatesi" : 21.1599254
},
"slug" : "prishtine"
}
},
"numri" : 1,
"dataNenshkrimit" : ISODate("2012-01-27T00:00:00Z"),
"komuna" : {
"emri" : "Prishtina",
"slug" : "Prishtina"
},
"vlera" : "Vlerë e vogël",
"procedura" : "Procedura e kuotimit të Çmimeve",
"aktiviteti" : "Transmetimin integral të seancave të Kuvendit."
}
Server Responses
- 200
OK
- The request was successful - 204
No Content
- the request was successful but there is no representation to return (i.e. the response is empty) - 400
Bad Request
- the request could not be understood or was missing required parameters. - 404
Not Found
- resource was not found.
All URL Params
string:komuna
Possible options:
ferizaj
gjakova
gjilan
prishtina
vitia
hani-i-elezit
int:year
Possible options:
2010
2011
2012
2013
2014
2015
2016
company-slug
Example
post-telekomi-i-kosoves
abc
Retrieving JSON data based on the budget type for the given municipality and year.
Required Prams
string:municipality
int:year
Sample Call: http://e-prokurimi.org/api/municipality-procurements/budget-type/prishtina/2012
Retrieving JSON data based on the procurement type for the given municipality and year.
Required Prams
string:municipality
int:year
Sample Call: http://e-prokurimi.org/api/municipality-procurements/procurement-type/prishtina/2012
Retrieving JSON data for number, price and value of the contracts for each month for the given municipality.
Required Prams
string:municipality
Sample Call: http://e-prokurimi.org/api/municipality-procurements/prishtine/monthly-summary
Retrieving JSON data of the company based on the company slug(company-slug). These data describe who contracted this company and the price of the contracts.
Required Prams
string:company-name
Sample Call: http://e-prokurimi.org/api/municipality-procurements/kompania/abc
Retrieving detailed JSON data about the company based on the company slug(company-slug). These data describe who contracted this company and the price of the contracts.
Required Prams
string:company-slug
Sample Call: http://e-prokurimi.org/api/municipality-procurements/kompania-detajet/abc
Retrieving JSON data based on red flags algorithm for the given municipality and year.
Required Prams
string:municipality
int:year
Sample Call: http://e-prokurimi.org/api/municipality-procurements/prishtina/red-flags/2012
Required Prams
string:municipality
int:year
Sample Call: http://e-prokurimi.org/api/municipality-procurements/prishtina/treemap/2012
Retrieving JSON data for the total value of contacts based on the procurement type for the given municipality and year.
Required Prams
string:municipality
int:year
Sample Call: http://e-prokurimi.org/api/municipality-procurements/ferizaj/piechart/2012