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

# Panggil REST APIs di API Gateway
<a name="how-to-call-api"></a>

Untuk memanggil API yang diterapkan, klien mengirimkan permintaan ke URL untuk layanan komponen API Gateway untuk eksekusi API, yang dikenal sebagai`execute-api`.

URL dasar untuk REST APIs adalah dalam format berikut: 

```
https://api-id.execute-api.region.amazonaws.com/stage/
```

di *api-id* mana pengenal API, *region* adalah AWS Wilayah, dan *stage* merupakan nama panggung penerapan API. 

**penting**  
Sebelum Anda dapat menjalankan API, Anda harus menerapkannya di API Gateway. Untuk petunjuk tentang penerapan API, lihat[Menerapkan REST APIs di API Gateway](how-to-deploy-api.md). 

**Topics**
+ [Mendapatkan URL pemanggilan API](#apigateway-how-to-call-rest-api)
+ [Memanggil API](#apigateway-call-api)
+ [Menggunakan konsol API Gateway untuk menguji metode REST API](how-to-test-method.md)
+ [Menggunakan Java SDK yang dihasilkan oleh API Gateway untuk REST API](how-to-call-apigateway-generated-java-sdk.md)
+ [Menggunakan Android SDK yang dihasilkan oleh API Gateway untuk REST API](how-to-generate-sdk-android.md)
+ [Menggunakan JavaScript SDK yang dihasilkan oleh API Gateway untuk REST API](how-to-generate-sdk-javascript.md)
+ [Menggunakan Ruby SDK yang dihasilkan oleh API Gateway untuk REST API](how-to-call-sdk-ruby.md)
+ [Menggunakan SDK iOS yang dihasilkan oleh API Gateway untuk REST API di Objective-C atau Swift](how-to-generate-sdk-ios.md)

## Mendapatkan URL pemanggilan API
<a name="apigateway-how-to-call-rest-api"></a>

Anda dapat menggunakan konsol, definisi OpenAPI AWS CLI, atau yang diekspor untuk mendapatkan URL pemanggilan API.

### Mendapatkan URL pemanggilan API menggunakan konsol
<a name="apigateway-obtain-url-console"></a>

Prosedur berikut menunjukkan cara mendapatkan URL pemanggilan API di konsol REST API.

**Untuk mendapatkan URL pemanggilan API menggunakan konsol REST API**

1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1. Pilih API yang diterapkan.

1. Dari panel navigasi utama, pilih **Stage**.

1. Di bawah **Detail tahap**, pilih ikon salin untuk menyalin URL pemanggilan API Anda.

   URL ini untuk sumber daya root API Anda.  
![\[Setelah Anda membuat REST API, konsol akan menampilkan URL pemanggilan API Anda.\]](http://docs.aws.amazon.com/id_id/apigateway/latest/developerguide/images/getting-started-rest-invoke-url.png)

1. Untuk mendapatkan URL pemanggilan API untuk sumber daya lain di API Anda, perluas tahapan di bawah panel navigasi sekunder, lalu pilih metode.

1. Pilih ikon salin untuk menyalin URL pemanggilan tingkat sumber daya API Anda.  
![\[URL tingkat sumber daya untuk REST API Anda berada di bawah panel navigasi sekunder panggung.\]](http://docs.aws.amazon.com/id_id/apigateway/latest/developerguide/images/resource-level-invoke-url.png)

#### Mendapatkan URL pemanggilan API menggunakan AWS CLI
<a name="apigateway-obtain-url-cli"></a>

Prosedur berikut menunjukkan cara mendapatkan URL pemanggilan API menggunakan. AWS CLI

**Untuk mendapatkan URL pemanggilan API menggunakan AWS CLI**

1. Gunakan perintah berikut untuk mendapatkan`rest-api-id`. Perintah ini mengembalikan semua `rest-api-id` nilai di Wilayah Anda. Untuk informasi selengkapnya, lihat [get-rest-apis](https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-rest-apis.html).

   ```
   aws apigateway get-rest-apis
   ```

1. Ganti contoh `rest-api-id` dengan Anda`rest-api-id`, ganti contoh *\$1stage-name\$1* dengan Anda*\$1stage-name\$1*, dan ganti*\$1region\$1*, dengan Wilayah Anda.

   ```
   https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}/
   ```

##### Memperoleh URL pemanggilan API menggunakan file definisi OpenAPI yang diekspor dari API
<a name="apigateway-obtain-url-openapi"></a>

Anda juga dapat membuat URL root dengan menggabungkan `host` dan `basePath` bidang file definisi OpenAPI yang diekspor dari API. Untuk petunjuk tentang cara mengekspor API Anda, lihat[Ekspor REST API dari API Gateway](api-gateway-export-api.md).

## Memanggil API
<a name="apigateway-call-api"></a>

[Anda dapat memanggil API yang digunakan menggunakan browser, curl, atau aplikasi lain, seperti Postman.](https://www.postman.com/)

Selain itu, Anda dapat menggunakan konsol API Gateway untuk menguji panggilan API. Pengujian menggunakan `TestInvoke` fitur API Gateway, yang memungkinkan pengujian API sebelum API diterapkan. Untuk informasi selengkapnya, lihat [Menggunakan konsol API Gateway untuk menguji metode REST API](how-to-test-method.md).

**catatan**  
Nilai parameter string kueri dalam URL pemanggilan tidak dapat berisi. `%%`

### Memanggil API menggunakan browser web
<a name="apigateway-call-api-brower"></a>

Jika API Anda mengizinkan akses anonim, Anda dapat menggunakan browser web apa pun untuk menjalankan metode apa pun`GET`. Masukkan URL pemanggilan lengkap di bilah alamat browser.

Untuk metode lain atau panggilan yang diperlukan otentikasi, Anda harus menentukan payload atau menandatangani permintaan. Anda dapat menangani ini dalam skrip di belakang halaman HTML atau dalam aplikasi klien menggunakan salah satu file AWS SDKs.

#### Memanggil API menggunakan curl
<a name="apigateway-call-api-curl"></a>

Anda dapat menggunakan alat seperti [curl](https://curl.se/) di terminal Anda untuk memanggil API Anda. Contoh perintah curl berikut memanggil metode GET pada `getUsers` sumber daya `prod` tahap API.

------
#### [ Linux or Macintosh ]

```
curl -X GET 'https://b123abcde4.execute-api.us-west-2.amazonaws.com/prod/getUsers'
```

------
#### [ Windows ]

```
curl -X GET "https://b123abcde4.execute-api.us-west-2.amazonaws.com/prod/getUsers"
```

------