Designing an API is complex, the proof being the quantity of technologies invented to try to simplify and standardize it: REST, GraphQL, HAL, JSON-LD, Hydra...

Designing an API for the future means ensuring its long-term stability: stability of input/output formats, versioning and deprecation management, inclusion of sub-resources, communication of changes to consumers...

Let's discuss these challenges and how to address them in the context of a Symfony API.