Greetings REST API designing and modeling is a beautiful art one can master. I was lucky to work in such an environment where we gave a lot of effort to design better APIs by following proper guidelines. Out of all the companies I worked for, it had the best guide on REST design. I thought to share my learning and some thoughts on REST API designing decisions one can take. The product domain is healthcare hence I am referring to the FHIR standard here as it is more generic and common for anyone. I choose the FHIR appointment as the discussion point.           Challenges    These are some of the challenges for any project that we will face.                There is a lot of logic on the client and there are other structural       problems after many years of development          Complex logic and difficult to grasp      Multiple modules are impacted             Support new requirements while preserving the running system behavior          Deliver on time      Need to support multiple con...
May all beings be happy, be well, be peaceful, and be free