

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memulai: Membuat GraphQL API pertama Anda di AWS AppSync
<a name="quickstart"></a>

Anda dapat menggunakan AWS AppSync konsol untuk mengonfigurasi dan meluncurkan GraphQL API. APIs GraphQL umumnya membutuhkan tiga komponen:

1. **Skema GraphQL** - Skema GraphQL Anda adalah cetak biru API. Ini mendefinisikan jenis dan bidang yang dapat Anda minta ketika operasi dijalankan. Untuk mengisi skema dengan data, Anda harus menghubungkan sumber data ke GraphQL API. Dalam panduan quickstart ini, kita akan membuat skema menggunakan model yang telah ditentukan.

1. **Sumber data** - Ini adalah sumber daya yang berisi data untuk mengisi GraphQL API Anda. Ini bisa berupa tabel DynamoDB, fungsi Lambda, dll AWS AppSync . Mendukung banyak sumber data untuk membangun GraphQL yang kuat dan terukur. APIs Sumber data ditautkan ke bidang dalam skema. Setiap kali permintaan dilakukan pada bidang, data dari sumber mengisi bidang. Mekanisme ini dikendalikan oleh resolver. Dalam panduan quickstart ini, kita akan membuat sumber data menggunakan model yang telah ditentukan di samping skema.

1. **Resolvers** - Resolver bertanggung jawab untuk menghubungkan bidang skema ke sumber data. Mereka mengambil data dari sumber, kemudian mengembalikan hasil berdasarkan apa yang didefinisikan oleh bidang. AWS AppSync mendukung keduanya JavaScript dan VTL untuk menulis resolver untuk GraphQL Anda. APIs Dalam panduan mulai cepat ini, resolver akan dibuat secara otomatis berdasarkan skema dan sumber data. Kami tidak akan mempelajari ini di bagian ini.

AWS AppSync mendukung pembuatan dan konfigurasi semua komponen GraphQL. Saat membuka konsol, Anda dapat menggunakan metode berikut untuk membuat API:

1. Merancang GraphQL API yang disesuaikan dengan menghasilkannya melalui model yang telah ditentukan dan menyiapkan tabel DynamoDB baru (sumber data) untuk mendukungnya.

1. Merancang GraphQL API dengan skema kosong dan tidak ada sumber data atau resolver.

1. Menggunakan tabel DynamoDB untuk mengimpor data dan menghasilkan jenis dan bidang skema Anda.

1. Menggunakan AWS AppSync WebSocket kemampuan dan Pub/Sub arsitektur untuk mengembangkan real-time APIs.

1. Menggunakan APIs GraphQL ( APIssumber) yang ada untuk menautkan ke API Gabungan.

**catatan**  
Kami merekomendasikan untuk meninjau bagian [Merancang skema](designing-your-schema.md#aws-appsync-designing-your-schema) sebelum bekerja dengan alat yang lebih canggih. Panduan ini akan menjelaskan contoh sederhana yang dapat Anda gunakan secara konseptual untuk membangun aplikasi yang lebih kompleks. AWS AppSync

AWS AppSync juga mendukung beberapa opsi non-konsol untuk membuat APIs GraphQL. Ini termasuk:

1. AWS Amplify

1. AWS SAM

1. CloudFormation

1. CDK

 Contoh berikut akan menunjukkan cara membuat komponen dasar dari GraphQL API menggunakan model yang telah ditentukan dan DynamoDB.

**Topics**
+ [Meluncurkan skema](schema-launch-start.md)
+ [Mengambil tur AWS AppSync konsol](console-tour.md)
+ [Menggunakan mutasi GraphQL untuk menambahkan data ke tabel DynamoDB](add-data-with-graphql-mutation.md)
+ [Menggunakan kueri GraphQL untuk mengambil data dari tabel DynamoDB](retrieve-data-with-graphql-query.md)
+ [Bagian tambahan](next-steps.md)

# Meluncurkan skema di konsol AWS AppSync
<a name="schema-launch-start"></a>

Dalam contoh ini, Anda akan membuat `Todo` API yang memungkinkan pengguna membuat `Todo` item untuk pengingat tugas harian seperti *Finish task* atau. *Pick up groceries* API ini akan mendemonstrasikan cara menggunakan operasi GraphQL di mana status tetap ada dalam tabel DynamoDB.

Secara konseptual, ada tiga langkah utama untuk membuat GraphQL API pertama Anda. Anda harus menentukan skema (tipe dan bidang), melampirkan sumber data Anda ke bidang Anda, lalu menulis resolver yang menangani logika bisnis. Namun, pengalaman konsol mengubah urutan ini. Kita akan mulai dengan mendefinisikan bagaimana kita ingin sumber data kita berinteraksi dengan skema kita, kemudian mendefinisikan skema dan resolver nanti.

**Untuk membuat GraphQL API**

1. Masuk ke Konsol Manajemen AWS dan buka [AppSync konsol](https://console.aws.amazon.com/appsync/). 

1. Di **Dashboard**, pilih **Create API**.

1. Sementara ** APIsGraphQL** dipilih, **pilih** Desain dari awal. Lalu, pilih **Selanjutnya**.

1. **Untuk **nama API**, ubah nama yang telah diisi sebelumnya menjadi**Todo API**, lalu pilih Berikutnya.**
**catatan**  
Ada juga opsi lain yang ada di sini, tetapi kami tidak akan menggunakannya untuk contoh ini.

1. Di bagian **Tentukan sumber daya GraphQL**, lakukan hal berikut:

   1. Pilih **Buat tipe yang didukung oleh tabel DynamoDB sekarang**.
**catatan**  
Ini berarti kita akan membuat tabel DynamoDB baru untuk melampirkan sebagai sumber data.

   1. Di bidang **Nama Model**, masukkan**Todo**.
**catatan**  
Persyaratan pertama kami adalah mendefinisikan skema kami. **Nama Model** ini akan menjadi nama tipe, jadi yang sebenarnya Anda lakukan adalah membuat `type` panggilan `Todo` yang akan ada dalam skema:  

      ```
      type Todo {}
      ```

   1. Di bawah **Fields**, lakukan hal berikut:

      1. Buat bidang bernama**id**, dengan tipe`ID`, dan wajib diatur ke`Yes`.
**catatan**  
Ini adalah bidang yang akan ada dalam lingkup `Todo` tipe Anda. Nama bidang Anda di sini akan dipanggil `id` dengan jenis`ID!`:  

         ```
         type Todo {
         	id: ID!
         }
         ```
AWS AppSync mendukung beberapa nilai skalar untuk kasus penggunaan yang berbeda. 

      1. Menggunakan **Tambahkan bidang baru**, buat empat bidang tambahan dengan `Name` nilai yang disetel ke**name**,**when**,**where**, dan**description**. `Type`Nilai-nilai mereka akan`String`, `Array` dan `Required` nilai dan keduanya akan diatur`No`. Itu akan terlihat seperti ini:  
![\[Model information form showing fields for a Todo model with ID, name, when, where, and description.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/model-information-tutorial.png)
**catatan**  
Tipe lengkap dan bidangnya akan terlihat seperti ini:  

         ```
         type Todo {
         	id: ID!
         	name: String
         	when: String
         	where: String
         	description: String
         }
         ```
Karena kami membuat skema menggunakan model yang telah ditentukan ini, itu juga akan diisi dengan beberapa mutasi boilerplate berdasarkan tipe seperti`create`,`delete`, dan `update` untuk membantu Anda mengisi sumber data Anda dengan mudah.

   1. Di bawah **konfigurasi tabel model**, masukkan nama tabel, seperti**TodoAPITable**. Atur **Primary Key** ke`id`.
**catatan**  
Kami pada dasarnya membuat tabel DynamoDB baru yang *TodoAPITable* disebut yang akan dilampirkan ke API sebagai sumber data utama kami. Kunci utama kami diatur ke `id` bidang wajib yang kami tetapkan sebelum ini. Perhatikan bahwa tabel baru ini kosong dan tidak berisi apa pun kecuali kunci partisi.

   1. Pilih **Berikutnya**.

1. Tinjau perubahan Anda dan pilih **Buat API**. Tunggu sebentar untuk membiarkan AWS AppSync layanan selesai membuat API Anda.

Anda telah berhasil membuat GraphQL API dengan skema dan sumber data DynamoDB. Untuk meringkas langkah-langkah di atas, kami memilih untuk membuat GraphQL API yang sama sekali baru. Kami mendefinisikan nama API, lalu menambahkan definisi skema kami dengan menambahkan tipe pertama kami. Kami mendefinisikan jenis dan bidangnya, lalu memilih untuk melampirkan sumber data ke salah satu bidang dengan membuat tabel DynamoDB baru tanpa data di dalamnya.

# Mengambil tur AWS AppSync konsol
<a name="console-tour"></a>

Sebelum kita menambahkan data ke tabel DynamoDB kita, kita harus meninjau fitur dasar dari pengalaman konsol. AWS AppSync Tab AWS AppSync konsol di sisi kiri halaman memungkinkan pengguna untuk dengan mudah menavigasi ke salah satu komponen utama atau opsi konfigurasi yang AWS AppSync menyediakan:

![\[AWS AppSync console navigation menu showing APIs, Todo API options, and Documentation link.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/explorer-example-5.jpg)


## Desainer skema
<a name="schema-designer"></a>

Pilih **Skema** untuk melihat skema yang baru saja Anda buat. Jika Anda meninjau konten skema, Anda akan melihat bahwa itu telah dimuat dengan banyak operasi pembantu untuk merampingkan proses pengembangan. Di editor **Skema**, jika Anda menggulir kode, Anda akhirnya akan mencapai model yang Anda tentukan di bagian sebelumnya:

```
type Todo {
	id: ID!
	name: String
	when: String
	where: String
	description: String
}
```

Model Anda menjadi tipe dasar yang digunakan di seluruh skema Anda. Kami akan mulai menambahkan data ke sumber data kami menggunakan mutasi yang secara otomatis dihasilkan dari jenis ini.

Berikut adalah beberapa tips dan fakta tambahan tentang editor **Skema**:

1. Editor kode memiliki kemampuan linting dan pemeriksaan kesalahan yang dapat Anda gunakan saat menulis aplikasi Anda sendiri.

1. Sisi kanan konsol menunjukkan tipe GraphQL yang telah dibuat dan resolver pada tipe tingkat atas yang berbeda, seperti kueri.

1. Saat menambahkan tipe baru ke skema (misalnya,`type User {...}`), Anda dapat AWS AppSync menyediakan sumber daya DynamoDB untuk Anda. Ini termasuk kunci primer yang tepat, kunci sortir, dan desain indeks agar paling sesuai dengan pola akses data GraphQL Anda. Jika Anda memilih **Buat Sumber Daya** di bagian atas dan memilih salah satu jenis yang ditentukan pengguna ini dari menu, Anda dapat memilih opsi bidang yang berbeda dalam desain skema. Kami akan membahas ini di bagian [desain skema](designing-your-schema.md#aws-appsync-designing-your-schema).

### Konfigurasi penyelesai
<a name="resolver-menu"></a>

Di perancang skema, bagian **Resolvers** berisi semua jenis dan bidang dalam skema Anda. **Jika Anda menggulir daftar bidang, Anda akan melihat bahwa Anda dapat melampirkan resolver ke bidang tertentu dengan memilih Lampirkan.** Ini akan membuka editor kode di mana Anda dapat menulis kode resolver Anda. AWS AppSync **mendukung VTL dan JavaScript runtime, yang dapat diubah di bagian atas halaman dengan memilih **Tindakan**, lalu Perbarui Runtime.** Di bagian bawah halaman, Anda juga dapat membuat fungsi yang akan menjalankan beberapa operasi secara berurutan. Namun, resolver adalah topik lanjutan, dan kami tidak akan membahasnya di bagian ini.

## Sumber data
<a name="data-sources-designer"></a>

Pilih **Sumber data** untuk melihat tabel DynamoDB Anda. Dengan memilih `Resource` opsi (jika tersedia), Anda dapat melihat konfigurasi sumber data Anda. Dalam contoh kita, ini mengarah ke konsol DynamoDB. Dari sana, Anda dapat mengedit data Anda. Anda juga dapat langsung mengedit beberapa data dengan memilih sumber data, lalu memilih **Edit**. Jika Anda perlu menghapus sumber data Anda, Anda dapat memilih sumber data Anda, lalu pilih **Hapus**. Terakhir, Anda dapat membuat sumber data baru dengan memilih **Buat sumber data**, lalu mengonfigurasi nama dan jenisnya. Perhatikan bahwa opsi ini untuk menautkan AWS AppSync layanan ke sumber daya yang ada. Anda masih perlu membuat sumber daya di akun Anda menggunakan layanan yang relevan sebelum AWS AppSync mengenalinya.

## Kueri
<a name="queries-editor"></a>

Pilih **Kueri** untuk melihat kueri dan mutasi Anda. Saat kami membuat GraphQL API menggunakan model kami AWS AppSync , secara otomatis menghasilkan beberapa mutasi dan kueri pembantu untuk tujuan pengujian. **Di editor kueri, sisi kiri berisi Explorer.** Ini adalah daftar yang menunjukkan semua mutasi dan kueri Anda. Anda dapat dengan mudah mengaktifkan operasi dan bidang yang ingin Anda gunakan di sini dengan mengklik nilai namanya. Ini akan menyebabkan kode muncul secara otomatis di bagian tengah editor. Di sini, Anda dapat mengedit mutasi dan kueri Anda dengan memodifikasi nilai. Di bagian bawah editor, Anda memiliki editor **Variabel Kueri** yang memungkinkan Anda memasukkan nilai bidang untuk variabel input operasi Anda. Memilih **Run** di bagian atas editor akan memunculkan daftar drop-down untuk memilih yang query/mutation akan dijalankan. Output untuk proses ini akan muncul di sisi kanan halaman. Kembali ke bagian **Explorer** di bagian atas, Anda dapat memilih operasi (Query, Mutation, Subscription), lalu pilih simbol **\$1** untuk menambahkan instance baru dari operasi tertentu. Di bagian atas halaman, akan ada daftar drop-down lain yang berisi mode otorisasi untuk kueri Anda berjalan. Namun, kami tidak akan membahas fitur tersebut di bagian ini (Untuk informasi lebih lanjut, lihat [Keamanan](security-authz.md#aws-appsync-security).).

## Pengaturan
<a name="console-settings"></a>

Pilih **Pengaturan** untuk melihat beberapa opsi konfigurasi untuk GraphQL API Anda. Di sini, Anda dapat mengaktifkan beberapa opsi seperti logging, tracing, dan fungsionalitas firewall aplikasi web. Anda juga dapat menambahkan mode otorisasi baru untuk melindungi data Anda dari kebocoran yang tidak diinginkan ke publik. Namun, opsi ini lebih maju dan tidak akan dibahas dalam bagian ini.

**catatan**  
Mode otorisasi default,`API_KEY`, menggunakan kunci API untuk menguji aplikasi. Ini adalah otorisasi dasar yang diberikan kepada semua APIs GraphQL yang baru dibuat. Kami menyarankan Anda menggunakan metode yang berbeda untuk produksi. Demi contoh di bagian ini, kita hanya akan menggunakan kunci API. Untuk informasi selengkapnya tentang metode otorisasi yang didukung, lihat [Keamanan](security-authz.md#aws-appsync-security).

# Menggunakan mutasi GraphQL untuk menambahkan data ke tabel DynamoDB di konsol AWS AppSync
<a name="add-data-with-graphql-mutation"></a>

Langkah Anda selanjutnya adalah menambahkan data ke tabel DynamoDB kosong Anda menggunakan mutasi GraphQL. Mutasi adalah salah satu jenis operasi mendasar dalam GraphQL. Mereka didefinisikan dalam skema dan memungkinkan Anda untuk memanipulasi data dalam sumber data Anda. Dalam hal REST APIs, ini sangat mirip dengan operasi seperti `PUT` atau`POST`.

**Untuk menambahkan data ke sumber data Anda**

1. Jika Anda belum melakukannya, masuk ke Konsol Manajemen AWS dan buka [AppSync konsol](https://console.aws.amazon.com/appsync/). 

1. Pilih API Anda dari tabel.

1. Di tab di sebelah kiri, pilih **Kueri.**

1. Di tab **Explorer** di sebelah kiri tabel, Anda mungkin melihat beberapa mutasi dan kueri yang sudah ditentukan di editor kueri:  
![\[Explorer tab showing a dropdown menu with mutation and query options like createTodo and deleteTodo.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/explorer-example-1.png)
**catatan**  
Mutasi ini sebenarnya duduk dalam skema Anda sebagai `Mutation` tipenya. Ini memiliki kode:  

   ```
   type Mutation {
   	createTodo(input: CreateTodoInput!): Todo
   	updateTodo(input: UpdateTodoInput!): Todo
   	deleteTodo(input: DeleteTodoInput!): Todo
   }
   ```
Seperti yang Anda lihat, operasi di sini mirip dengan apa yang ada di dalam editor kueri.

   AWS AppSync secara otomatis menghasilkan ini dari model yang kita definisikan sebelumnya. Contoh ini akan menggunakan `createTodo` mutasi untuk menambahkan entri ke tabel kita*TodoAPITable*.

1. Pilih `createTodo` operasi dengan memperluasnya di bawah `createTodo` mutasi:  
![\[Expanded createTodo mutation showing input fields like description, id, name, when, and where.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/explorer-example-2.png)

   Aktifkan kotak centang untuk semua bidang seperti gambar di atas.
**catatan**  
Atribut yang Anda lihat di sini adalah elemen mutasi yang dapat dimodifikasi yang berbeda. Anda `input` dapat dianggap sebagai parameter dari`createTodo`. Berbagai opsi dengan kotak centang adalah bidang yang akan dikembalikan dalam respons setelah operasi dilakukan.

1. Di editor kode di tengah layar, Anda akan melihat bahwa operasi muncul di bawah mutasi: `createTodo`

   ```
   mutation createTodo($createtodoinput: CreateTodoInput!) {
     createTodo(input: $createtodoinput) {
       where
       when
       name
       id
       description
     }
   }
   ```
**catatan**  
Untuk menjelaskan cuplikan ini dengan benar, kita juga harus melihat kode skema. Deklarasi `mutation createTodo($createtodoinput: CreateTodoInput!){}` adalah mutasi dengan salah satu operasinya,`createTodo`. Mutasi penuh terletak di skema:  

   ```
   type Mutation {
   	createTodo(input: CreateTodoInput!): Todo
   	updateTodo(input: UpdateTodoInput!): Todo
   	deleteTodo(input: DeleteTodoInput!): Todo
   }
   ```
Kembali ke deklarasi mutasi dari editor, parameternya adalah objek yang dipanggil `$createtodoinput` dengan tipe input yang diperlukan dari. `CreateTodoInput` Perhatikan bahwa `CreateTodoInput` (dan semua input dalam mutasi) juga didefinisikan dalam skema. Misalnya, inilah kode boilerplate untuk: `CreateTodoInput`  

   ```
   input CreateTodoInput {
   	name: String
   	when: String
   	where: String
   	description: String
   }
   ```
Ini berisi bidang yang kami definisikan dalam model kami, yaitu`name`,`when`,`where`, dan`description`.  
Kembali ke kode editor, di`createTodo(input: $createtodoinput) {}`, kami mendeklarasikan input sebagai`$createtodoinput`, yang juga digunakan dalam deklarasi mutasi. Kami melakukan ini karena ini memungkinkan GraphQL untuk memvalidasi input kami terhadap jenis yang disediakan dan memastikan bahwa mereka digunakan dengan input yang benar.  
Bagian terakhir dari kode editor menunjukkan bidang yang akan dikembalikan dalam respons setelah operasi dilakukan:  

   ```
   {
       where
       when
       name
       id
       description
     }
   ```

   Di tab **Query variable** di bawah editor ini, akan ada `createtodoinput` objek generik yang mungkin memiliki data berikut:

   ```
   {
     "createtodoinput": {
       "name": "Hello, world!",
       "when": "Hello, world!",
       "where": "Hello, world!",
       "description": "Hello, world!"
     }
   }
   ```
**catatan**  
Di sinilah kami mengalokasikan nilai untuk input yang disebutkan sebelumnya:  

   ```
   input CreateTodoInput {
   	name: String
   	when: String
   	where: String
   	description: String
   }
   ```

   Ubah `createtodoinput` dengan menambahkan informasi yang ingin kita masukkan ke dalam tabel DynamoDB kita. Dalam hal ini, kami ingin membuat beberapa `Todo` item sebagai pengingat:

   ```
   {
     "createtodoinput": {
       "name": "Shopping List",
       "when": "Friday",
       "where": "Home",
       "description": "I need to buy eggs"
     }
   }
   ```

1. Pilih **Jalankan** di bagian atas editor. Pilih **CreateTodo** di daftar drop-down. Di sisi kanan editor, Anda akan melihat responsnya. Mungkin terlihat seperti ini:

   ```
   {
     "data": {
       "createTodo": {
         "where": "Home",
         "when": "Friday",
         "name": "Shopping List",
         "id": "abcdefgh-1234-1234-1234-abcdefghijkl",
         "description": "I need to buy eggs"
       }
     }
   }
   ```

   Jika Anda menavigasi ke layanan DynamoDB, Anda sekarang akan melihat entri di sumber data Anda dengan informasi ini:  
![\[TodoAPITable interface showing a completed scan with 1 item returned in a table format.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/explorer-example-3.png)

Untuk meringkas operasi, mesin GraphQL mengurai catatan, dan resolver memasukkannya ke dalam tabel Amazon DynamoDB Anda. Sekali lagi, Anda dapat memverifikasi ini di konsol DynamoDB. Perhatikan bahwa Anda tidak perlu memasukkan `id` nilai. An `id` dihasilkan dan dikembalikan dalam hasil. Ini karena contoh menggunakan `autoId()` fungsi dalam resolver GraphQL untuk kunci partisi yang disetel pada sumber daya DynamoDB Anda. Kami akan membahas bagaimana Anda dapat membangun resolver di bagian yang berbeda. Perhatikan `id` nilai yang dikembalikan; Anda akan menggunakannya di bagian berikutnya untuk mengambil data dengan kueri GraphQL.

# Menggunakan kueri GraphQL untuk mengambil data dari tabel DynamoDB di konsol AWS AppSync
<a name="retrieve-data-with-graphql-query"></a>

Sekarang catatan ada di database Anda, Anda akan mendapatkan hasil ketika Anda menjalankan kueri. Query adalah salah satu operasi fundamental lainnya dari GraphQL. Ini digunakan untuk mengurai dan mengambil informasi dari sumber data Anda. Dalam hal REST APIs, ini mirip dengan `GET` operasi. Keuntungan utama dari kueri GraphQL adalah kemampuan untuk menentukan persyaratan data yang tepat aplikasi Anda sehingga Anda mengambil data yang relevan pada waktu yang tepat. 

**Untuk menanyakan sumber data Anda**

1. Jika Anda belum melakukannya, masuk ke Konsol Manajemen AWS dan buka [AppSync konsol](https://console.aws.amazon.com/appsync/). 

1. Pilih API Anda dari tabel.

1. Di tab di sebelah kiri, pilih **Kueri.**

1. Di tab **Explorer** di sebelah kiri tabel, di bawah `query``listTodos`, perluas `getTodo` operasi:  
![\[Expanded getTodo operation showing fields id, description, name, when, and where.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/explorer-example-4.png)

1. Di editor kode, Anda akan melihat kode operasi:

   ```
   query listTodos {
     getTodo(id: "") {
       description
       id
       name
       when
       where
     }
   ```

   Masuk`(id:"")`, isi nilai yang Anda simpan dalam hasil dari operasi mutasi. Dalam contoh kami, ini akan menjadi:

   ```
   query listTodos {
     getTodo(id: "abcdefgh-1234-1234-1234-abcdefghijkl") {
       description
       id
       name
       when
       where
     }
   ```

1. Pilih **Run**, lalu **ListTodos**. Hasilnya akan muncul di sebelah kanan editor. Contoh kami terlihat seperti ini:

   ```
   {
     "data": {
       "getTodo": {
         "description": "I need to buy eggs",
         "id": "abcdefgh-1234-1234-1234-abcdefghijkl",
         "name": "Shopping List",
         "when": "Friday",
         "where": "Home"
       }
     }
   }
   ```
**catatan**  
Kueri hanya mengembalikan bidang yang Anda tentukan. Anda dapat membatalkan pilihan bidang yang tidak Anda perlukan dengan menghapusnya dari bidang pengembalian:  

   ```
   {
       description
       id
       name
       when
       where
     }
   ```
Anda juga dapat menghapus centang pada kotak di tab **Explorer** di sebelah bidang yang ingin Anda hapus.

1. Anda juga dapat mencoba `listTodos` operasi dengan mengulangi langkah-langkah untuk membuat entri di sumber data Anda, lalu mengulangi langkah-langkah kueri dengan operasi. `listTodos` Berikut adalah contoh di mana kami menambahkan tugas kedua:

   ```
   {
     "createtodoinput": {
       "name": "Second Task",
       "when": "Monday",
       "where": "Home",
       "description": "I need to mow the lawn"
     }
   }
   ```

   Dengan memanggil `listTodos` operasi, itu mengembalikan entri lama dan baru:

   ```
   {
     "data": {
       "listTodos": {
         "items": [
           {
             "id": "abcdefgh-1234-1234-1234-abcdefghijkl",
             "name": "Shopping List",
             "when": "Friday",
             "where": "Home",
             "description": "I need to buy eggs"
           },
           {
             "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
             "name": "Second Task",
             "when": "Monday",
             "where": "Home",
             "description": "I need to mow the lawn"
           }
         ]
       }
     }
   }
   ```

# Bagian tambahan untuk konsol AWS AppSync
<a name="next-steps"></a>

Bagian ini adalah referensi untuk AWS AppSync topik yang lebih maju. Sebaiknya ikuti bagian *Bacaan Tambahan* sebelum melakukan hal lain.

## Integrasi
<a name="app-integration"></a>

Di tab konsol, jika Anda memilih nama API Anda, halaman **Integrasi** akan muncul:

![\[AWS AppSync sidebar menu with APIs, Todo API highlighted, and other options listed.\]](http://docs.aws.amazon.com/id_id/appsync/latest/devguide/images/explorer-example-6.png)


Ini merangkum langkah-langkah untuk menyiapkan API Anda dan menguraikan langkah selanjutnya untuk membangun aplikasi klien. Bagian **Integrasikan dengan aplikasi Anda** memberikan detail penggunaan [toolchain AWS Amplify](https://aws-amplify.github.io/) untuk mengotomatiskan proses menghubungkan API Anda dengan iOS, Android, dan JavaScript aplikasi melalui konfigurasi dan pembuatan kode. Amplify toolchain memberikan dukungan penuh untuk membangun proyek dari workstation lokal Anda termasuk penyediaan GraphQL dan alur kerja untuk CI/CD.

Bagian **Sampel Klien** juga mencantumkan contoh aplikasi klien (misalnya JavaScript, iOS, Android) untuk menguji end-to-end pengalaman. Anda dapat mengkloning dan mengunduh sampel ini, dan file konfigurasi memiliki informasi yang diperlukan (seperti URL titik akhir Anda) yang Anda butuhkan untuk memulai. Ikuti petunjuk di halaman [AWS Amplify toolchain](https://aws-amplify.github.io/) untuk menjalankan aplikasi Anda.

## Bacaan tambahan
<a name="supplemental-reading-quickstart"></a>
+ [Merancang GraphQL APIs dengan AWS AppSync](designing-a-graphql-api.md)- Ini adalah panduan komprehensif untuk membuat GraphQL Anda menggunakan skema kosong tanpa sumber data atau resolver.