Light

hackeac / mtaaapi Goto Github PK

View Code? Open in Web Editor NEW

15.0 3.0 1.0 212 KB

A simple API to access Tanzania's location information

Home Page: https://mtaa-api.herokuapp.com

License: MIT License

Python 36.15% CSS 45.15% HTML 18.70%

tanzania-locations api locations

mtaaapi's Introduction

Mtaa API

Mtaa API is a simple REST(And later GraphQL) API for accessing Tanzania locations.

Mtaa API is powered by mtaa.

Why?

Most of the time when coding, we found ourselves in need of some location data, especially for our country, Tanzania.

We didn't like the idea of scraping some public sites because we had the feeling that we was spending more time understanding the site and cleaning the data than focusing on my task.

But we liked the idea of a public API for developers. So I decided to code a little Flask server inspired by our tanzania-locations-db, mtaa and here is Mtaa API.

You can find it running here and are free to use it in your developments: https://mtaa-api.herokuapp.com/api.

I hope you will find it useful.

Features

No registration
Zero-config
Basic API
Cross-domain (CORS)
Supports GET and POST(GraphQL) verbs
Compatible with React, Angular, Vue, Ember, ...

Guide

For examples and more, documentation you can visit https://mtaa-api.herokuapp.com/docs

mtaaapi's People

Contributors

Stargazers

Watchers

Forkers

kalebu

mtaaapi's Issues

It includes "postal_codes" from wards

Hello,

Great work with the API.

I think there are issues where you are including ward_postal_code data in "wards" instead of it being on its own field/object.

This is only happening in "wards" response.

TTP/1.1 200 OK
Access-Control-Allow-Origin: *
Connection: keep-alive
Content-Length: 260
Content-Type: application/json
Date: Sun, 21 Feb 2021 06:12:40 GMT
Server: gunicorn/20.0.4
Via: 1.1 vegur

{
    "post_code": "413",
    "wards": [
        "ward_post_code",
        "Bahi",
        "Ibihwa",
        "Ilindi",
        "Kigwe",
        "Mpamamtwa",
        "Chali",
        "Chikola",
        "Chipanga",
        "Nondwa",
        "Mpalanga",
        "Lamaiti",
        "Makanda",
        "Msisi",
        "Mundemu",
        "Zanka",
        "Chibelela",
        "Ibugule",
        "Mtitaa",
        "Mwitikira",
        "Chifutuka",
        "Mpinga",
        "Babayu"
    ]
}

Heroku app is down

A request to Heroku results into Status: 503 Service Unavailable
probably something broke during deployment !!

Documentation Missing

Just wrote an OpenAPI Documentation for the MtaaAPI

https://app.swaggerhub.com/apis/Kalebu/mtaa-api_documentation/1.0

Have a look at it and then you can add it to the description if all is well

Deploy the latest changes to heroku

https://mtaa-api.herokuapp.com/api/tanzania/Mbeya still raises internal server error

Can you please deploy the latest changes to heroku ?

Exceptional handling should be added

When someone tries to access a location that's is not there,
the current implementation just throws 500 Internal Error

We can add exception handling to handle this and returning empty [ ] or { }
when exceptional is thrown

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.