@JohnDoDo One first question: Does the media type define the contract between my server and client? Yes, media type is one part of the contract. Contract in REST API is not static unlike SOAP(i.e. WSDL). Contract is defined by combination of underlying protocol(i.e. HTTP), URIs and Media Types(it’s not prohibited to use several media types … Read more
There’s a lot of confusion about this, because most applications that call themselves REST don’t use hypermedia and aren’t REST at all. Hypermedia is a generalization of hypertext for content other than HTML. You can say hypertext is a subset of hypermedia. Hypermedia can be HTML in a browser, with all links, buttons and everything … Read more
The Serializer Bundle alone might not be enough for this situation as it is only concerned with serialization and deserialization, not more complex semantical tasks. I would suggest looking into FSCHateoasBundle to implement a pretty hypermedia format for your API.
The Book Building Microservices describes in detail the styles mentioned by @RogerAlsing in his answer. On page 43 under Orchestration vs Choreography the book says: As we start to model more and more complex logic, we have to deal with the problem of managing business processes that stretch across the boundary of individual services. And … Read more