Pragmatic web API guidlines

When starting to create a new system, or participating in a new team or project, there is a simple but profound question: Is there a design specification for the API of this system (Web Server)? image by stable difussion, prompt by alswl This issue has bothered me for a long time, starting during my school days, and every time I needed to communicate and discuss with my team members. From the initial free style to the later REST, I often referenced Github v3 to the project team and the Foursqure API (no longer accessible, exposing age) documentation. However, in practice, there are still cases where there is a mismatch with the actual work or the common company specification. This is when I need to do some additional work. Eventually, I will write a brief DEVELOPMENT.md document to describe the design solution. ...