If you’re looking for more details than the Slack article check out Zalando’s full API guidelines. There’s lots of details you don’t have to adopt, but I’m thankful they open sourced their guidelines for others to learn from. Every decision on this guide likely comes with years of lessons learned.