diff --git a/_posts/en/2017-08-24-api-platform-en.md b/_posts/en/2017-08-24-api-platform-en.md index 6732c6b10..d452419f1 100644 --- a/_posts/en/2017-08-24-api-platform-en.md +++ b/_posts/en/2017-08-24-api-platform-en.md @@ -23,7 +23,7 @@ In this article, we're going to build an API using API Platform, and talk about We'll create an API around a single resource: _movie._ Indeed, we will build something that adds, deletes and updates movies. The first thing we need to do is creating our data model. A movie is made of a title, a release date, actors, a director... Many properties known from everyone. -If we go through the documentation, we can see that we can generate our entities with [Schema.org](http://schema.org). This allows us to use a common language to define our usual resources (_Book, Organization_, _Person_…){:rel="nofollow noreferrer"}, but it's also understood by search engines like Google or Yahoo. +If we go through the documentation, we can see that we can generate our entities with [Schema.org](http://schema.org). This allows us to use a common language to define our usual resources (_Book, Organization_, _Person_…), but it's also understood by search engines like Google or Yahoo. Good for us, there is a _Movie_ entity from _Schema.org_, with many interesting properties. For simplicity, we'll only work with some of them. @@ -52,7 +52,8 @@ Last but not least, we need to update the database to be able to play with our m bin/console do:sche:update --force vendor/bin/schema generate-types src/ app/config/schema.yml ``` -![](/assets/2017-07-25-api-platform/api_platform_movies.png)Accessing documentation, you see that the _Movie_ resource is here, with all operations like creating, updating, and deleting. +![](/assets/2017-07-25-api-platform/api_platform_movies.png) +Accessing documentation, you see that the _Movie_ resource is here, with all operations like creating, updating, and deleting. You can play with the interface and the auto-generated documentation before we go on and see another feature used many times in API: filters. ## Filters and sorts diff --git a/_posts/fr/2017-07-25-api-platform.md b/_posts/fr/2017-07-25-api-platform.md index 5f80184bb..51247fcf2 100644 --- a/_posts/fr/2017-07-25-api-platform.md +++ b/_posts/fr/2017-07-25-api-platform.md @@ -22,7 +22,7 @@ Dans cet article, nous allons voir ensemble la création d’une API avec Api Pl Dans notre article, nous allons créer une API autour d’une seule ressource : _movie._ En effet, nous allons simplement créer une API permettant d’ajouter, supprimer, mettre à jour et récupérer des films. La première chose à faire consiste à créer notre modèle de données. Un film est composé d’un titre, d’une date de sortie, d’acteurs, d’un réalisateur… Plusieurs propriétés qui sont connues de tous. -Si l’on parcourt la documentation d’API Platform, on peut voir qu’il nous est possible de générer nos modèles d’après [Schema.org](http://schema.org). Ce dernier permet d’utiliser un langage commun pour définir des ressources de tous les jours (_Book, Organization_, _Person_…){:rel="nofollow noreferrer"}, mais est surtout compris par les moteurs de recherche comme Google ou Yahoo. +Si l’on parcourt la documentation d’API Platform, on peut voir qu’il nous est possible de générer nos modèles d’après [Schema.org](http://schema.org). Ce dernier permet d’utiliser un langage commun pour définir des ressources de tous les jours (_Book, Organization_, _Person_…), mais est surtout compris par les moteurs de recherche comme Google ou Yahoo. Il existe donc l’entité _Movie_ au sein de _Schema.org_, avec de nombreuses propriétés qui nous intéressent. Pour la simplicité de lecture, nous allons en sélectionner uniquement quelques-unes. @@ -51,7 +51,8 @@ Enfin, il nous reste à mettre à jour la base de données pour pouvoir jouer av bin/console do:sche:update --force vendor/bin/schema generate-types src/ app/config/schema.yml ``` -![](/assets/2017-07-25-api-platform/api_platform_movies.png)En accédant à la documentation, vous apercevrez que la ressource _Movie_ est maintenant là, accompagnée de toutes les opérations de création, modification, suppression. +![](/assets/2017-07-25-api-platform/api_platform_movies.png) +En accédant à la documentation, vous apercevrez que la ressource _Movie_ est maintenant là, accompagnée de toutes les opérations de création, modification, suppression. Je vous laisse jouer avec l’interface et la documentation auto-générée avant de passer à une fonctionnalité très utilisée dans les API de listing : les filtres. ## Filtres et sort