Nov 1, 2018

Designing API

API Design

API is about designing an interface for developers to use. API is redefining how business is done. Developers are expected to be able to construct standards compliant, expressive, secure and performant APIs.
There are many ways to design an API. You can go with a well defined specification like SOAP, or you maybe embrace the newer REST paradigm and adopt a community standard like HALJSON-LD,Collection+JSONSIREN or JSON API. Then you need to think about how you design these APIs, using something like Swagger or RAML.
The discipline is still evolving very fast.