#ICYDK: When developing a mobile or cloud app, creating automated business processes, or making an app that is front and backend divided, we will probably write a REST API. In a few words, a REST API is a set of functions with which developers can perform requests and receive responses via HTTP protocol such as GET and POST. Digging deeper, developers learn about HTTP methods purposes and message formats. They focus on how to provide and process data, forgetting, that their API will be actually used by other developers and their application users. In this article, I will describe what usually tends to be overlooked by people who develop an API but is important for those who will use it.
#1 Error Reporting
Error responses are as important as successful ones. They affect applications that use our API — on the basis of errors developers change program behaviors and provide information to users. Due to the above, error responses should be consistent and thought out. Being aware of common mistakes will improve their usability: https://goo.gl/tXseHw