Mise en route : création de votre première API GraphQL - AWS AppSync

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise en route : création de votre première API GraphQL

Vous pouvez utiliserAWS AppSyncconsole pour configurer et lancer une API GraphQL. Les API GraphQL nécessitent généralement trois composants :

  1. Schéma GraphQL- Votre schéma GraphQL est le modèle de l'API. Il définit les types et les champs que vous pouvez demander lorsqu'une opération est exécutée. Pour remplir le schéma avec des données, vous devez connecter les sources de données à l'API GraphQL. Dans ce guide de démarrage rapide, nous allons créer un schéma à l'aide d'un modèle prédéfini.

  2. Sources de données- Il s'agit des ressources qui contiennent les données permettant de remplir votre API GraphQL. Il peut s'agir d'une table DynamoDB, d'une fonction Lambda, etc.AWS AppSyncprend en charge une multitude de sources de données pour créer des API GraphQL robustes et évolutives. Les sources de données sont liées aux champs du schéma. Chaque fois qu'une demande est effectuée sur un champ, les données de la source renseignent le champ. Ce mécanisme est contrôlé par le résolveur. Dans ce guide de démarrage rapide, nous allons créer une source de données à l'aide d'un modèle prédéfini associé au schéma.

  3. Résolveurs- Les résolveurs sont chargés de lier le champ de schéma à la source de données. Ils récupèrent les données de la source, puis renvoient le résultat en fonction de ce qui a été défini par le champ.AWS AppSyncprend en charge les deuxJavaScriptet VTL pour écrire des résolveurs pour vos API GraphQL. Dans ce guide de démarrage rapide, les résolveurs seront automatiquement générés en fonction du schéma et de la source de données. Nous n'allons pas approfondir cette question dans cette section.

AWS AppSyncprend en charge la création et la configuration de tous les composants GraphQL. Lorsque vous ouvrez la console, vous pouvez utiliser les méthodes suivantes pour créer votre API :

  1. Conception d'une API GraphQL personnalisée en la générant via un modèle prédéfini et en configurant une nouvelle table DynamoDB (source de données) pour la prendre en charge.

  2. Conception d'une API GraphQL avec un schéma vide, sans sources de données ni résolveurs.

  3. Utilisation d'une table DynamoDB pour importer des données et générer les types et les champs de votre schéma.

  4. En utilisantAWS AppSyncc'estWebSocketcapacités et architecture Pub/Sub pour développer des API en temps réel.

  5. Utilisation des API GraphQL existantes (API source) pour établir un lien vers une API fusionnée.

Note

Nous vous recommandons de consulter leConception d'un schémasection avant de travailler avec des outils plus avancés. Ces guides expliqueront des exemples plus simples que vous pouvez utiliser de manière conceptuelle pour créer des applications plus complexes dansAWS AppSync.

AWS AppSyncprend également en charge plusieurs options hors console pour créer des API GraphQL. Il s'agit des licences suivantes :

  1. AWS Amplify

  2. AWS SAM

  3. AWS CloudFormation

  4. Le CDK

L'exemple suivant vous montre comment créer les composants de base d'une API GraphQL à l'aide de modèles prédéfinis et de DynamoDB.

Rubriques