API Colombia is a public RESTful API that enables users to access a wide range of public information about the country of Colombia.
Read this document in Español
- Minimal API's endpoints to get information about:
- General information about the country.
- Departments/States.
- Cities.
- Presidents.
- Tourist attractions.
- Natural Areas
- Airports
- Swagger documentation
- Does not require authentication.
- Clone this repository here.
- The develop branch is the most stable branch at any given time, please make sure you're working from it.
- .NET CORE SDK must be installed in the machine.
- Update the connection string to your preferred database in the "appsettings.json" file.
- Run the
dotnet buildcommand to generate the build of the project.
The public page api-colombia.com has useful information about the API and a brief description of the available endpoints and the same allows access to the endpoints described below.
- Swagger documentation can be found at the following URL
| Repo | Url | Description |
|---|---|---|
| https://github.com/Mteheran/invasivespecie-colombia | https://especiesinvasoras.api-colombia.com/ | A portal to consult all invasive species in Colombia |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/city | Get the list of all cities |
| GET | /api/{version}/city/{id} | Get the information of a city by it is id |
| GET | /api/{version}/city/name/{name} | Get the information of a city by it is name |
| GET | /api/{version}/city/search/{keyword} | Get the information of a city searching by keyword |
| GET | /api/{version}/city/pagedList | Get the list of all cities paginated |
| GET | /api/{version}/country/Colombia | Get the information of Colombia |
| GET | /api/{version}/Department | Get the list of all departments in Colombia |
| GET | /api/{version}/Department/{id} | Get the information of a department by it is id |
| GET | /api/{version}/Department/name/{name} | Get the information of a department by it is name |
| GET | /api/{version}/Department/search/{keyword} | Get the information of a department searching by keyword |
| GET | /api/{version}/Department/pagedList | Get the list of all department paginated |
| GET | /api/{version}/Region | Get the list of all regions in Colombia |
| GET | /api/{version}/President | Get the list of all presidents in Colombia |
| GET | /api/{version}/President/{id} | Get the information of a president by it is id |
| GET | /api/{version}/President/name/{name} | Get the information of a president by it is name |
| GET | /api/{version}/President/year/{name} | Get the information of a president that ruled during a specific year |
| GET | /api/{version}/President/search/{keyword} | Get the information of a president searching by keyword |
| GET | /api/{version}/President/pagedList | Get the list of all presidents paginated |
| GET | /api/{version}/TouristicAttraction | Get the list of all touristic attractions in Colombia |
| GET | /api/{version}/TouristicAttraction/{id} | Get the information of a touristic attraction by it is id |
| GET | /api/{version}/TouristicAttraction/name/{name} | Get the information of a touristic attaction by it is name |
| GET | /api/{version}/TouristicAttraction/search/{keyword} | Get the information of a touristic attaction searching by keyword |
| GET | /api/{version}/TouristicAttraction/pagedList | Get the list of all touristic attractions paginated |
- Content type: "application/json". Responses are JSON Objects.
- Response header contains the HTTP CODE with the status.
- Example:
{
"id": 1,
"name": "Colombia",
"description": "Colombia, officially the Republic of Colombia, is a country in South America with insular regions in North America—near Nicaragua's Caribbean coast—as well as in the Pacific Ocean. The Colombian mainland is bordered by the Caribbean Sea to the north, Venezuela to the east and northeast, Brazil to the southeast, Ecuador and Peru to the south and southwest, the Pacific Ocean to the west, and Panama to the northwest. Colombia is divided into 32 departments and the Capital District of Bogotá, the country's largest city. It covers an area of 1,141,748 square kilometers (440,831 sq mi), and has a population of 52 million. Colombia's cultural heritage—including language, religion, cuisine, and art—reflects its history as a Spanish colony, fusing cultural elements brought by immigration from Europe and the Middle East, with those brought by enslaved Africans, as well as with those of the various Indigenous civilizations that predate colonization. Spanish is the official state language, although English and 64 other languages are recognized regional languages.",
"stateCapital": "Bogotá",
"surface": 1141748,
"population": 52235050,
"languages": [
"Spanish",
"English"
],
"timeZone": "UTC-5",
"currency": "Colombian Peso",
"currencyCode": "COP",
"isoCode": "CO",
"internetDomain": ".co",
"phonePrefix": "+57",
"radioPrefix": "HK",
"aircraftPrefix": "HK"
}- .NET Core 8.* is a free, cross-platform, open source developer platform for building many kinds of applications. .NET is built on a high-performance runtime that is used in production by many high-scale apps.
- PostgreSQL is a powerful, open source object-relational database system with over 35 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance.
- Microsoft Azure The Azure cloud platform is more than 200 products and cloud services designed to help you bring new solutions to life—to solve today’s challenges and create the future. Build, run, and manage applications across multiple clouds, on-premises, and at the edge, with the tools and frameworks of your choice.
Thanks goes to these wonderful people (emoji key):
 Miguel Teheran 💻 |
 Rina Plata 📖 ✅ |
 Veronica Guaman 💻 |
 Mario Botero 💻 |
 Alejandro Herreño 📖 💻 |
 Angelo Cardona 📖 💻 |
|
 Hamilton Galeano 📖 |
||||||
Add your contributions
|
||||||
This project follows the all-contributors specification. Contributions of any kind welcome!
MIT License