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

# Membuat permintaan API kueri menggunakan protokol AWS kueri di Amazon SQS
<a name="sqs-making-api-requests-xml"></a>

Topik ini menjelaskan cara membuat endpoint Amazon SQS, membuat permintaan GET dan POST, dan menafsirkan tanggapan.

## Membangun titik akhir
<a name="sqs-api-constructing-endpoints"></a>

Agar dapat bekerja dengan antrian Amazon SQS, Anda harus membuat titik akhir. Untuk informasi tentang titik akhir Amazon SQS, lihat halaman berikut di: *Referensi Umum Amazon Web*
+ [Titik akhir regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region)
+ [Titik akhir dan kuota Layanan Antrian Sederhana Amazon](https://docs.aws.amazon.com/general/latest/gr/sqs-service)

Setiap titik akhir Amazon SQS bersifat independen. Misalnya, jika dua antrian diberi nama *MyQueue*dan satu memiliki titik akhir `sqs.us-east-2.amazonaws.com` sementara yang lain memiliki titik akhir`sqs.eu-west-2.amazonaws.com`, kedua antrian tidak berbagi data apa pun satu sama lain.

Berikut ini adalah contoh dari endpoint yang membuat permintaan untuk membuat antrian. 

```
https://sqs.eu-west-2.amazonaws.com/   
?Action=CreateQueue
&DefaultVisibilityTimeout=40
&QueueName=MyQueue
&Version=2012-11-05
&AUTHPARAMS
```

**catatan**  
Nama antrian dan antrian peka huruf URLs besar/kecil.  
Struktur *`AUTHPARAMS`* tergantung pada tanda tangan permintaan API. Untuk informasi selengkapnya, lihat [Menandatangani Permintaan AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) di *Referensi Umum Amazon Web Services*.

## Membuat permintaan GET
<a name="structure-get-request"></a>

Permintaan Amazon SQS GET disusun sebagai URL yang terdiri dari berikut ini:
+ **Endpoint** — Sumber daya tempat permintaan bertindak ([nama antrian dan URL](sqs-queue-message-identifiers.md#queue-name-url)), misalnya: `https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue`
+ **Tindakan** — [Tindakan](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html) yang ingin Anda lakukan di titik akhir. Tanda tanya (`?`) memisahkan titik akhir dari tindakan, misalnya: `?Action=SendMessage&MessageBody=Your%20Message%20Text`
+ **Parameter — Parameter** permintaan apa pun. Setiap parameter dipisahkan oleh ampersand (`&`), misalnya: `&Version=2012-11-05&AUTHPARAMS` 

Berikut ini adalah contoh permintaan GET yang mengirim pesan ke antrian Amazon SQS.

```
https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue
?Action=SendMessage&MessageBody=Your%20message%20text
&Version=2012-11-05
&AUTHPARAMS
```

**catatan**  
Nama antrian dan antrian peka huruf URLs besar/kecil.  
Karena permintaan GET adalah URLs, Anda harus mengkodekan URL semua nilai parameter. Karena spasi tidak diizinkan masuk URLs, setiap spasi dikodekan URL sebagai. `%20` Contoh lainnya tidak dikodekan URL untuk membuatnya lebih mudah dibaca.

## Membuat permintaan POST
<a name="structure-post-request"></a>

Permintaan Amazon SQS POST mengirimkan parameter kueri sebagai formulir di badan permintaan HTTP.

Berikut ini adalah contoh header HTTP dengan `Content-Type` set ke`application/x-www-form-urlencoded`.

```
POST /123456789012/MyQueue HTTP/1.1
Host: sqs.us-east-2.amazonaws.com
Content-Type: application/x-www-form-urlencoded
```

Header diikuti oleh permintaan `[form-urlencoded](https://www.w3.org/MarkUp/html-spec/html-spec_8.html#SEC8.2)` GET yang mengirim pesan ke antrian Amazon SQS. Setiap parameter dipisahkan oleh ampersand ()`&`.

```
Action=SendMessage
&MessageBody=Your+Message+Text
&Expires=2020-10-15T12%3A00%3A00Z
&Version=2012-11-05
&AUTHPARAMS
```

**catatan**  
Hanya header `Content-Type` HTTP yang diperlukan. Sama seperti untuk permintaan GET. `AUTHPARAMS`  
Klien HTTP Anda mungkin menambahkan item lain ke permintaan HTTP, sesuai dengan versi HTTP klien.