

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Primeiros passos: Criando sua primeira API GraphQL em AWS AppSync
<a name="quickstart"></a>

Você pode usar o AWS AppSync console para configurar e iniciar uma API GraphQL. O GraphQL APIs geralmente requer três componentes:

1. **Esquema do GraphQL:** trata-se do esquema da API. Ele define os tipos e campos que você pode solicitar quando uma operação é executada. Para preencher o esquema com dados, você deve conectar as fontes de dados à API do GraphQL. Neste guia de início rápido, criaremos um esquema usando um modelo predefinido.

1. **Fontes de dados:** são os recursos que contêm os dados para preencher a API do GraphQL. Isso pode ser uma tabela do DynamoDB, uma função Lambda, etc AWS AppSync . Suporta uma infinidade de fontes de dados para criar um GraphQL robusto e escalável. APIs As fontes de dados estão vinculadas aos campos no esquema. Sempre que uma solicitação é executada em um campo, os dados da fonte preenchem o campo. Esse mecanismo é controlado pelo resolvedor. Neste guia de início rápido, criaremos uma fonte de dados usando um modelo predefinido juntamente com o esquema.

1. **Resolvedores:** os resolvedores são responsáveis por vincular o campo do esquema à fonte de dados. Eles recuperam os dados da fonte e, em seguida, retornam o resultado com base no que foi definido pelo campo. AWS AppSync suporta ambos JavaScript e VTL para escrever resolvedores para seu GraphQL. APIs Neste guia de início rápido, os resolvedores serão gerados automaticamente com base no esquema e na fonte de dados. Não vamos nos aprofundar nisso nesta seção.

AWS AppSync suporta a criação e configuração de todos os componentes do GraphQL. Ao abrir o console, você pode usar os seguintes métodos para criar a API:

1. Projetar uma API do GraphQL personalizada gerando-a por meio de um modelo predefinido e configurando uma nova tabela do DynamoDB (fonte de dados) para suportá-la.

1. Projetando uma API do GraphQL com um esquema em branco e sem fontes de dados ou resolvedores.

1. Usando uma tabela do DynamoDB para importar dados e gerar os tipos e campos do esquema.

1. Usando AWS AppSync os WebSocket recursos e a Pub/Sub arquitetura da para desenvolver em tempo real APIs.

1. Usando o GraphQL existente APIs (fonte APIs) para vincular a uma API mesclada.

**nota**  
Recomendamos ler a seção [Criar um esquema](designing-your-schema.md#aws-appsync-designing-your-schema) antes de trabalhar com ferramentas mais avançadas. Esses guias explicarão exemplos mais simples que você pode usar conceitualmente para criar aplicativos mais complexos. AWS AppSync

AWS AppSync também oferece suporte a várias opções que não são de console para criar o GraphQL APIs. Isso inclui:

1. AWS Amplify

1. AWS SAM

1. CloudFormation

1. O CDK

 O exemplo a seguir mostrará como criar os componentes básicos de uma API do GraphQL usando modelos predefinidos e o DynamoDB.

**Topics**
+ [Como iniciar um esquema](schema-launch-start.md)
+ [Fazendo um tour pelo AWS AppSync console](console-tour.md)
+ [Uso de mutações do GraphQL para adicionar dados a uma tabela do DynamoDB](add-data-with-graphql-mutation.md)
+ [Uso de consultas do GraphQL para recuperar dados de uma tabela do DynamoDB](retrieve-data-with-graphql-query.md)
+ [Seções complementares](next-steps.md)