Découvrir API Platform

Comprendre les formats de sortie

TESTEZ LINKEDIN LEARNING GRATUITEMENT ET SANS ENGAGEMENT

Tester maintenant Afficher tous les abonnements
Il existe plusieurs formats de sortie de services web. Dans cette vidéo, vous verrez comment publier des services web au format XML ou JSON.
03:24

Transcription

Avec « API Platform », vous allez travailler sur du « Content Negotiation », c'est ce que ça veut dire, le « Content Negotiation », en fait, c'est la négociation de contenu qui va vous permettre de fournir à vos utilisateurs, à ceux qui vont, en fait, consommer votre « API », différents formats et ces différents formats, on va pouvoir les configurer, les mettre à disposition ou pas, c'est vraiment en fonction de ce qu'on a envie de faire avec son « API ». Sur la page de documentation « API Plarform », on vous explique quels sont les formats qui seront supportés, qui seront possibles de mettre en place du coup, au travers « d'API Platform ». On a le « JSON-LD », alors, c'est le « JSON-LD » qu'on a déjà utilisé, en fait, c'est celui qu'on utilise un petit peu depuis le début, c'est ce qui nous permet, concrètement, d'avoir nos différents objets donc exactement ce qu'on a là, sous format « JSON » avec les « links », les fameux liens qui permettent d'aller, par exemple, vers une entité qui est liée. Ça, c'est le « JSON-LD », c'est celui qui, plus ou moins, est maintenant plus rependu et qui s’utilise un peu le plus souvent dans les applications parce qu'il permet de ne pas toujours faire les sous-requêtes et donc, de charger des objets qui sont moins lourds. On a également cette norme ; le « JSONHAL », vous irez regarder un petit peu, c'est l'hypertexte « application language » et ici, on a pas mal d'explications sur ces mises en place et sur son utilisation. Alors, ça va fonctionner à peu près comme le « JSON-LD », sauf que cette fois-ci, on aura, en fait, un sous-objet « links » dans lequel on aura des informations de relation avec la route à aller récupérer, le format de la route pour récupérer les objets et puis s'il y en a des objets liés. C'est le format, en fait, qui va changer un petit peu et c'est vrai qu'en fonction de la terminaison finale, c'est-à-dire en fonction du logiciel qui va venir consommer votre « API », il est important de pouvoir fournir des formats différents. Ici, on a également la possibilité de fournir du « JSON » simple, alors, le « JSON » simple, du coup, il va être dépourvu des informations de « link » et tout va être mis directement dans l'objet. C'est intéressant dans certains cas, mais pas forcément dans tous, notamment en termes de rapidité. Il sera plus intéressant d'utiliser le « JSON-LD », de faire des sous-requêtes quand on en a besoin, plutôt que de charger des objets. Là, on travaille en plus avec une petite application, on a un seul objet « Task » qui a un utilisateur, ce n'est pas une application très lourde. Si vous avez de très grosses applications avec beaucoup d'objets liés, ça risque devenir un petit peu « IP » et on vous ne conseillera pas de partir sur du « JSON », plutôt du « JSON-LD ». On a encore le « XML » qui peut être activé, le « XML » est un très vieux format maintenant, mais qui reste quand même répandu dans pas mal de domaines, il y a beaucoup d’entreprises qui utilisent encore le « XML ». Il y a la possibilité, bien évidemment, avec « API Platform » de fournir les objet au format « XML ». Et puis, en fin, un « HTML ». Alors là, on vous parle du « HTML », mais en réalité, vous n'allez pas pouvoir fournir du « HTML » pour vos objets, c'est pour la « doc ». La « doc », c'est vrai qu'elle nous permet, effectivement, elle est auto-générée, de fournir une documentation technique sur nos différents objets, sur les différentes routes, sur ce qui est possible de faire avec notre « API ». Ça, c'est le format « HTML », celui-là est un peu classique, est un peu par défaut. Voilà, pour les différents contenus et pour les différents formats que l'on peut implémenter, je vais vous montrer comment on les active ou désactive.

Découvrir API Platform

Prenez en main le framework API Platform. Voyez comment effectuer sa configuration, créer des services web de données, et réalisez ainsi efficacement une application complète.

3h24 (54 vidéos)
Aucun commentaire n´est disponible actuellement

Votre formation est disponible en ligne avec option de téléchargement. Bonne nouvelle : vous ne devez pas choisir entre les deux. Dès que vous achetez une formation, vous disposez des deux options de consultation !

Le téléchargement vous permet de consulter la formation hors ligne et offre une interface plus conviviale. Si vous travaillez sur différents ordinateurs ou que vous ne voulez pas regarder la formation en une seule fois, connectez-vous sur cette page pour consulter en ligne les vidéos de la formation. Nous vous souhaitons un excellent apprentissage avec cette formation vidéo.

N'hésitez pas à nous contacter si vous avez des questions !