https://dev.to/stripe/designing-apis-for-humans-object-ids-3o5a
A four part guide on how to design APIs that prioritize the human writing software to consume the APIs