The Case for Boring APIs
Public APIs are infrastructure, not art projects. The best APIs are predictably boring: they use standard REST conventions, maintain consistency across all endpoints, and let developers build a mental model after using just one endpoint. When your API tries to be clever with novel patterns or inconsistent structures, integration goes from hours to days. Save your innovation for your product and let your API fade into the background where it belongs.