Your API is a Contract. Stop Writing It in Crayon.

Building an endpoint is easy. You define a route, query the database, and return a JSON object. A junior developer can do it in ten minutes. Designing an API that survives for five years, supports three different client platforms, and doesn't require...