Here’s also some good recommendations: https://jcs.org/2023/07/12/api

That’s good too. Regarding:

> Be descriptive in your error responses

This is a useful standardised format:

RFC 7807: Problem Details for HTTP APIs

— https://datatracker.ietf.org/doc/html/rfc7807