My friend was complaining that his iOS engineer made horrible API design decisions. I didn’t feel like I could discuss this intelligently so I started looking up materials on what makes a good API.
on software apis:
Its great if you invest in a way to interact with your api for members on the mobile team or other services. Technologies like Swagger, RAML and Api Blueprint allow you to spec out apis in a highlevel language and, in some instances, generate production code.