This is a specification for building JSON HTTP API endpoints for exchanging data between e.g. clients and servers.
/api/<version>/<entity>/<action>/<identifier>
Serving the API under a separate /api
path is optional, it usually helps to route requests correctly. If this rule is applied it should be consistently used for all endpoints.