intro to api design first and OpenAPI, using OpenAPI at all the phases of your lifecycle including contract testing and simplifying server side code, spectral to make an api style guide so your APIs become eventually consistent whether they’re built yet or not. Then leaving the OpenAPI stuff alone a bit there’s how to make APIs awesome through evolution and depredations, standards that make life easy, all sorts.
Teacher API - Split up in smaller teams and let each team design one microservice.
Each team will define endpoints, bare minimum entities and relations between entities.
Tool Suggestions
- Stoplight Studio - Web-based is free for one user only. Desktop is free if you give them your email address.
- Apicur Studio - Web-Based and open-source.
- Various text editors on openapi.tools.
Resources
Send a pull request to this repo with the OpenAPI defined as /apis/team-name/openapi.yaml.
Swap with another team and try to build some really simple API consumer code to interact with a mock of the API.
Create a list of constructive feedback, for sharing with the group.
Suggestions
- Try multiple mock tools in the team
- Interact with the mock via curl or a simple HTTP client like Insomnia first
- Write code when you have a good HTTP client interaction
Tool Suggestions
Compile a list of feedback and make a written API style guide together.