We now recently had to design an internal system to manage student data. We went with REST and the first thing I did is to document all API-s in a repository us

We now recently had to design an internal system to manage student data. We went with REST and the first thing I did is to document all API-s in a repository using Swagger. It's not really true that there are no standards, they defined Open API, it has a nice browser based editor to update the YAML files and it's easy to read an maintain. All changes to the API-s are done via pull requests, so changes are reviewed. The HTTP verb is also a non issue, there's 4... FOUR that you need to match with CRUD. Is that hard? Even if it is, read the docs.