second: prefer a "topic-comment" style API with repetition than flat API where it's up to the service what fields can be configured together.
A good example is an API for defining http, tcp, or grpc ports
What are some random API design choices that you like?
What are some things people don't often think about when making APIs?
Yes, I am building an API. No, I can't be more specific at this time.


