It is recomended to develop this project in conjuntion with the StartWars Blog Reading List, you will eventually integrate both projects and have a fully functional applications with backend and front-end.
Today we are going to build one API to manage a blog (about StartWars), users on this blog will be able to list planets, list characters and create or remove favorites.
To allow users to do all of this, we must follow these steps:
Do not clone this repository.
The first step to start coding is cloning the flask or the express.js boilerplate (depending on your cohort main backend language).
a) If using Gitpod (recommended) you can clone the python boilerplate by clicking here or the node.js boilerplate by clicking here.
b) If working locally type the following command from your command line:
For Python/Flask: $ git clone https://github.com/4GeeksAcademy/flask-rest-hello For Node/Express.js: $ git clone https://github.com/4GeeksAcademy/expressjs-rest-hello
(you will need to have a database installed and python 3.7+ installed if you do it locally but all of that it's already installed on Gitpod)
The boiplerplate's README files has a video on how to start and complete your API.
π For python: There is an interactive tutorial on how to build a Flask API, its a similar process but instead of tasks
here you will be dealing with people
and planets
.
π‘ Important: Remember to create a new repository, update the remote (git remote set-url origin <your new url>
), and upload the code to your new repository using add
, commit
and push
.
Create an API that connects to a database and implements the following Endpoints (very similar to SWAPI.dev or SWAPI.tech):
[GET] /people
Get a list of all the people in the database[GET] /people/<int:people_id>
Get a one single people information[GET] /planets
Get a list of all the planets in the database[GET] /planets/<int:planet_id>
Get one single planet informationAditionally create the following endpoints to allow your StartWars blog to have users and favorites:
[GET] /users
Get a list of all the blog post users[GET] /users/favorites
Get all the favorites that belong to the current user.[POST] /favorite/planet/<int:planet_id>
Add a new favorite planet to the current user with the planet id = planet_id
.[POST] /favorite/people/<int:planet_id>
Add a new favorite people to the current user with the people id = people_id
.[DELETE] /favorite/planet/<int:planet_id>
Delete favorite planet with the id = planet_id
.[DELETE] /favorite/people/<int:people_id>
Delete favorite people with the id = people_id
.βοΈ Note: here is a sample API in Postman: https://documenter.getpostman.com/view/2432393/TzRSgnTS#a4174b48-3fc8-46e3-bf82-19a08107666f
This exercise will make you practice the following fundamentals:
The following requirements are not necesary to successfully complete this project, but you want try coding them if you feel like challenging yourself βΊοΈ
+1
Create also an enpoint to add (POST), update (PUT), and delete (DELETE) planets and people, that way all the database information can be manage using the API instead of having to rely on the flask admin to create the plantes and people.
All rights reserved, 4Geeks LLC 2021. Read more about 4Geeks and what we are going here.