When an enterprise architect is tasked with designing an API, he or she may go down several different paths. Some may gravitate toward using SOAP, while others may choose REST. Although either interface model can be effective, an API best practice would be to consider all options.
In this tip, expert Tom Nolle urges developers to apply API best practices to design applications that are ready for use in the cloud age. For example, Nolle recommends focusing on data elements as self-defining, rather than thinking solely of customer parameters.
Read more here: API best practices for cloud-ready application development