Algeria API
This is another Algerian administrative areas repository
Features
- Exposes a RESTful API
- JSON Files
- Postal codes by wilaya results/postal-codes-results.json
- Wilayas list (with Dairas and Baladiyahs lists) results/WilayaList.json
API Documentation
Find the full API documentation here (Will be moved to a SWAGGER documentation).
TODOs & Future Improvements/Features
- Build a dashboard to manage/correct data
- Match each postal code withe its provinces
- Add long/latt cordinates
- Improve data validation (see
tools/validateDataSchemas.jsanddata/WilayaList.schema.json)
Contributing
When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with us before making a change. And also, please make sure to read our guidelines for contributing
Improving the API (new features, bug fixes...)
If you want to work on the API server, just pull this repository then run npm install
To run the development server
npm run server:dev
# or
yarn server:dev
To run in Docker
npm run docker:prod
# Or
yarn docker:prod
Improving the Wilayas List (translations, corrections...)
The wilaya models are auto-generated by crawling and by using the fine work of mohsenuss91/AlgerianAdministrativeDivision. If you want to contribute more by adding, correcting or improving the results... Please create an issue so we can discuss it, and then you just need to update the results on results/WilayaList.json
License
This project is licensed under the MIT License - see the LICENSE file for details
Acknowledgments
- mohsenuss91/AlgerianAdministrativeDivision
- AbderrahmeneDZ/Wilaya-Of-Algeria/Wilaya_Of_Algeria.json
- Postal codes and Dairas list are collected by crawling the Algérie Poste and Interior ministry websites, the scripts I used are in tools/