diff --git a/components/serializer.rst b/components/serializer.rst index a7c2b00c221..a155341c2c9 100644 --- a/components/serializer.rst +++ b/components/serializer.rst @@ -1424,7 +1424,7 @@ Learn more .. seealso:: Normalizers for the Symfony Serializer Component supporting popular web API formats - (JSON-LD, GraphQL, HAL and JSONAPI) are available as part of the `API Platform`_ project. + (JSON-LD, GraphQL, OpenAPI, HAL, JSON:API) are available as part of the `API Platform`_ project. .. seealso:: diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst index 1e6bc32ca3c..81937863b36 100644 --- a/quick_tour/flex_recipes.rst +++ b/quick_tour/flex_recipes.rst @@ -174,7 +174,7 @@ Are you building an API? You can already return JSON easily from any controller: } } -But for a *truly* rich API, try installing `Api Platform`_: +But for a *truly* rich API, try installing `API Platform`_: .. code-block:: terminal @@ -259,5 +259,5 @@ build features *without* sacrificing code quality or performance. It's all about the service container, and it's Symfony's super power. Read on: about :doc:`/quick_tour/the_architecture`. .. _`https://flex.symfony.com`: https://flex.symfony.com -.. _`Api Platform`: https://api-platform.com/ +.. _`API Platform`: https://api-platform.com/ .. _`Twig`: https://twig.symfony.com/ diff --git a/serializer.rst b/serializer.rst index d432305ae65..f4d4a406144 100644 --- a/serializer.rst +++ b/serializer.rst @@ -202,8 +202,19 @@ value: Going Further with the Serializer --------------------------------- -`ApiPlatform`_ provides an API system supporting `JSON-LD`_ and `Hydra Core Vocabulary`_ -hypermedia formats. It is built on top of the Symfony Framework and its Serializer +`API Platform`_ provides an API system supporting the following formats: + +* `JSON-LD`_ along with the `Hydra Core Vocabulary`_ +* `OpenAPI`_ v2 (formerly Swagger) and v3 +* `GraphQL`_ +* `JSON:API`_ +* `HAL`_ +* JSON +* XML +* YAML +* CSV + +It is built on top of the Symfony Framework and its Serializer component. It provides custom normalizers and a custom encoder, custom metadata and a caching system. @@ -218,7 +229,11 @@ take a look at how this bundle works. serializer/custom_normalizer .. _`APCu`: https://github.com/krakjoe/apcu -.. _`ApiPlatform`: https://github.com/api-platform/core +.. _`API Platform`: https://api-platform.com .. _`JSON-LD`: http://json-ld.org .. _`Hydra Core Vocabulary`: http://hydra-cg.com +.. _`OpenAPI`: https://www.openapis.org +.. _`GraphQL`: https://graphql.org +.. _`JSON:API`: https://jsonapi.org +.. _`HAL`: http://stateless.co/hal_specification.html .. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs