Good thread on why designing an API upfront is a bad idea.

Design it based on needs of consumers.

That's why I think https://docs.pact.io/ is great, because it flips the
relation and lets consumers describe what they want, and the API needs to
provide that. https://twitter.com/stilkov/status/1250355402501492736