Table of Contents
- UGANDA DATA LIB
- Support Me
UGANDA DATA LIB
- Welcome to the Uganda Data Project documentation. This guide will help you get started with accessing data related to districts, counties, sub-counties, parishes, and villages in Uganda through the Uganda Data Project API.
Prerequisites
Before you begin, ensure that you have the following prerequisite:
- Uganda Data Project Account: Visit uganda.rapharm.shop and sign up for an account if you don't have one.
Generating API Key
Once you have an account on the Uganda Data Project, follow these steps to generate an API key:
- Log in to your Uganda Data Project account at uganda.rapharm.shop.
- Navigate to your profile settings.
- Under the "API Keys" section, generate an API key. Keep this key secure.
Accessing Data Through API
Now that you have an API key, you can access data through the Uganda Data Project Library:
- Use the API key in your requests to authenticate methods within the Library.
- Explore the available datasets related to districts, counties, sub-counties, parishes, and villages in Uganda.
- Follow the Library documentation for details on endpoints, parameters, and response formats.
Feel free to customize the content further based on the specific API features and setup process of the Uganda Data Project.
Authorization
The Uganda Data Project API utilizes API keys for authorization, ensuring secure access to its services. To interact with the API, users must possess valid API credentials, which can be generated from the "API Keys" section within their Uganda Data Project account.
API Key Authorization
API Key Authorization involves including a unique API key in the HTTP headers of the API request. The Uganda Data Project API utilizes this method to authenticate and authorize users.
Generating API Key
Follow these steps to generate an API key:
-
Log in to Your Uganda Data Project Account:
- Visit uganda.rapharm.shop and log in to your Uganda Data Project account.
-
Navigate to API Keys:
- In your account profile settings, find the "API Keys" section. This is where you can generate and manage your API keys.
-
Generate API Key:
- Inside the "API Keys" section, find an option to generate a new API key. Click on this option to create a unique key for API access.
-
Copy Your API Key:
- Once generated, copy your API key. This key serves as your authentication token.
Using API Key
To make API requests, include your API key in the HTTP headers of your requests. Here is an example using the curl command-line tool:
Description
The Uganda Data Library is a JavaScript library that provides an interface to the Uganda Rapharm API, allowing users to retrieve information about districts, counties, sub-counties, parishes, and villages.
Installation
To install the library, use npm:
npm install uganda-data-lib
or use yarn
yarn add uganda-data-lib
Usage
const UgandaData = require('uganda-data-lib');
const ugandaDataLib = new UgandaData("Your_api_key");
ugandaDataLib.fetchDistricts()
.then(data => console.log(data))
.catch(error => console.error(error.message));This table explains how to get data about districts
| Method | Description | Parameters | Return Type |
|---|---|---|---|
constructor(apiKey) |
Initializes an instance of the class. |
apiKey (string) |
- |
setApiKey(apiKey) |
Sets the API key and headers for the request. |
apiKey (string) |
- |
async fetchData(url) |
Fetches data but you dont need to call this method . |
url (string) |
Promise<any> |
async fetchDistricts(limit, page, sort_order) |
Fetches the districts with specified limit, page, and sort order. |
limit (number, default: 100), page (number, default: 1), sort_order (string, default: "asc") |
Promise<any> |
async fetchDistrict(uuid) |
Fetches a district from the Library based on the given UUID. |
uuid (string) |
Promise<any> |
async fetchDistrictCounty(uuid) |
Fetches a county from the Library based on the given UUID of a district. |
uuid (string) |
Promise<any> |
async fetchDistrictSubcounty(uuid) |
Fetches a sub-county from the Library based on the given UUID of a district. |
uuid (string) |
Promise<any> |
async fetchDistrictParish(uuid) |
Fetches a parish from the Library based on the given UUID of a district. |
uuid (string) |
Promise<any> |
async fetchDistrictVillage(uuid) |
Fetches a village from the Library based on the given UUID of a district. |
uuid (string) |
Promise<any> |
This table explains how to get data about counties
| Method | Description | Parameters | Return Type |
|---|---|---|---|
async fetchCounties(limit, page, sort_order) |
Fetches all the counties from the API. |
limit (number, default: 100), page (number, default: 1), sort_order (string, default: "asc") |
Promise<any> |
async fetchCountySubcounty(uuid) |
Fetches a sub-county from the API based on the given UUID of a county. |
uuid (string) |
Promise<any> |
async fetchCountyParish(uuid) |
Fetches a parish from the API based on the given UUID of a county. |
uuid (string) |
Promise<any> |
async fetchCountyVillage(uuid) |
Fetches a village from the API based on the given UUID of a county. |
uuid (string) |
Promise<any> |
This table explains how to get data about counties
| Method | Description | Parameters | Return Type |
|---|---|---|---|
async fetchSubcounties(limit, page, sort_order) |
Fetches all the sub-counties from the API. |
limit (number, default: 100), page (number, default: 1), sort_order (string, default: "asc") |
Promise<any> |
async fetchSubcountyParish(uuid) |
Fetches a parish from the API based on the given UUID of a sub-county. |
uuid (string) |
Promise<any> |
async fetchSubcountyVillage(uuid) |
Fetches a village from the API based on the given UUID of a sub-county. |
uuid (string) |
Promise<any> |
This table explains how to get data about parishes
| Method | Description | Parameters | Return Type |
|---|---|---|---|
async fetchParishes(limit, page, sort_order) |
Fetches all the parishes from the API. |
limit (number, default: 100), page (number, default: 1), sort_order (string, default: "asc") |
Promise<any> |
async fetchParish(uuid) |
Fetches a parish from the API based on the given UUID. |
uuid (string) |
Promise<any> |
async fetchParishVillage(uuid) |
Fetches a village from the API based on the given UUID of a parish. |
uuid (string) |
Promise<any> |
This table explains how to get data about villages
| Method | Description | Parameters | Return Type |
|---|---|---|---|
async fetchVillages(limit, page, sort_order) |
Fetches all the villages from the API. |
limit (number, default: 100), page (number, default: 1), sort_order (string, default: "asc") |
Promise<any> |
async fetchVillage(uuid) |
Fetches a village from the API based on the given UUID. |
uuid (string) |
Promise<any> |
Contributing to UGANDA DATA LIB
Thank you for considering contributing to UGANDA DATA LIB! Contributions are welcome from everyone.
How to Contribute
- Fork the repository on GitHub.
- Clone your forked repository to your local machine.
git clone https://github.com/your-username/uganda-data-lib.git
cd uganda-data-lib
git checkout -b feature-name
git commit -m "Your descriptive commit message"
git push origin feature-nameSupport Me
If you find this project helpful and would like to support its development, you have a few options:
Financial Contributions
Your financial support helps keep this project actively maintained and improved.
Mobile Money Contributions
If you prefer to contribute via mobile money, you can use the following numbers:
- MTN Mobile Money: +256 781 230 949
- Airtel Money: +256 759 983 853
Your support is greatly appreciated!
Visit My Website
For more about me and my projects, you can visit my website
Hire Me
If you're looking for a developer with expertise , I'm available for hire. Feel free to contact me for more information.
Thank you for supporting this project!