{"id":15640361,"url":"https://github.com/fcmam5/algeria-api","last_synced_at":"2025-03-30T01:31:34.698Z","repository":{"id":40617396,"uuid":"189779682","full_name":"Fcmam5/algeria-api","owner":"Fcmam5","description":"The 🇩🇿 API (Work in progress)","archived":true,"fork":false,"pushed_at":"2023-01-06T02:23:03.000Z","size":2512,"stargazers_count":83,"open_issues_count":53,"forks_count":11,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2025-02-16T04:17:02.644Z","etag":null,"topics":["algeria","algeria-api","dz","postal-codes"],"latest_commit_sha":null,"homepage":"https://algeria-api.herokuapp.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Fcmam5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-01T21:37:45.000Z","updated_at":"2025-01-19T19:47:38.000Z","dependencies_parsed_at":"2023-02-05T03:01:20.421Z","dependency_job_id":null,"html_url":"https://github.com/Fcmam5/algeria-api","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fcmam5%2Falgeria-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fcmam5%2Falgeria-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fcmam5%2Falgeria-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fcmam5%2Falgeria-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fcmam5","download_url":"https://codeload.github.com/Fcmam5/algeria-api/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246264820,"owners_count":20749533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algeria","algeria-api","dz","postal-codes"],"created_at":"2024-10-03T11:34:51.546Z","updated_at":"2025-03-30T01:31:34.299Z","avatar_url":"https://github.com/Fcmam5.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Algeria API\n\n[![Known Vulnerabilities](https://snyk.io/test/github/Fcmam5/algeria-api/badge.svg)](https://snyk.io/test/github/Fcmam5/algeria-api) [![Mutation testing badge](https://img.shields.io/endpoint?style=flat\u0026url=https://badge-api.stryker-mutator.io/github.com/Fcmam5/algeria-api/develop)](https://dashboard.stryker-mutator.io/reports/github.com/Fcmam5/algeria-api/develop)\n\nThis is another Algerian administrative areas repository :smiley:. In this project we provide a structured JSON and XML data that can be found in [results/WilayaList.json](./data/WilayaList.json) and [results/WilayaList.XML](./data/WilayaList.XML) or through our API: [https://algeria-api.herokuapp.com/api/v1/]()\n\n## Features\n\n- Exposes a RESTful API\n- JSON Files\n  - Postal codes by wilaya [results/postal-codes-results.json](./data/postal-codes-results.json)\n  - Wilayas list (with Dairas and Baladiyahs lists) [results/WilayaList.json](./data/WilayaList.json)\n\n## API Documentation\n\nFind the full API documentation [here](https://documenter.getpostman.com/view/6370698/SW12ywmH?version=latest) (_Will be moved to a SWAGGER documentation_).\n\n## TODOs \u0026 Future Improvements/Features\n\n- Build a dashboard to manage/correct data\n- Match each postal code withe its provinces\n- Add long/latt cordinates\n- Improve data validation (see [`tools/validateDataSchemas.js`](./tools/validateDataSchemas.js) and [`data/WilayaList.schema.json`](./data/WilayaList.schema.json))\n\n## Contributing\n\nWhen 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](CONTRIBUTING.md)\n\n### Improving the API (new features, bug fixes...)\n\n:pencil: :whale: :globe_with_meridians: :building_construction: :bug: :zap: :construction_worker: :sparkles:\n\nIf you want to work on the API server, just pull this repository then run `npm install`\n\nTo run the development server\n\n```\nnpm run server:dev\n# or\nyarn server:dev\n```\n\nTo run in Docker\n\n```\nnpm run docker:prod\n# Or\nyarn docker:prod\n```\n\n### Improving the Wilayas List (translations, corrections...)\n\n:pencil: :globe_with_meridians: :building_construction: :bug: :zap: :construction_worker: :sparkles:\n\nThe wilaya models are auto-generated by crawling and by using the fine work of [mohsenuss91/AlgerianAdministrativeDivision](https://github.com/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](./data/WilayaList.json)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details\n\n## Acknowledgments\n\n- [mohsenuss91/AlgerianAdministrativeDivision](https://github.com/mohsenuss91/AlgerianAdministrativeDivision)\n- [AbderrahmeneDZ/Wilaya-Of-Algeria/Wilaya_Of_Algeria.json](https://github.com/AbderrahmeneDZ/Wilaya-Of-Algeria/blob/master/Wilaya_Of_Algeria.json)\n- Postal codes and Dairas list are collected by crawling the [Algérie Poste](https://www.poste.dz/) and [Interior ministry](http://www.interieur.gov.dz/) websites, the scripts I used are in [tools/](./tools/README.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffcmam5%2Falgeria-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffcmam5%2Falgeria-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffcmam5%2Falgeria-api/lists"}