API Architecture and Specification 

We design custom web APIs according to Open API specifications. From our experience, well-designed web APIs should aim to support:

• Platform independence. Any client should be able to call the API, regardless of how the API is implemented internally. This requires using standard protocols and a mechanism whereby the client and the web service agree on the format of the data to exchange.
• Service evolution. The web API should be able to evolve and add functionality independently from client applications. As the API evolves, existing client applications should continue to function without modification. All functionality should be discoverable so client applications can fully use it.