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á.
# Fazendo solicitações de API de AWS consulta usando o protocolo de consulta no Amazon SQS
Este tópico explica como criar um endpoint do Amazon SQS, fazer solicitações GET e POST e interpretar respostas.
## Criar um endpoint
Para trabalhar com filas do Amazon SQS, você deve criar um endpoint. Para ter informações sobre endpoints do Amazon SQS, consulte as seguintes páginas na *Referência geral da Amazon Web Services*:
+ [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region)
+ [Endpoints e cotas do Amazon Simple Queue Service](https://docs.aws.amazon.com/general/latest/gr/sqs-service)
Cada endpoint do Amazon SQS é totalmente independente. Por exemplo, se duas filas forem nomeadas *MyQueue*, uma tiver um endpoint `sqs.us-east-2.amazonaws.com` e a outra tiver o endpoint `sqs.eu-west-2.amazonaws.com`, elas não compartilham dados entre si.
Veja a seguir um exemplo de um endpoint que faz uma solicitação para criar uma fila.
```
https://sqs.eu-west-2.amazonaws.com/
?Action=CreateQueue
&DefaultVisibilityTimeout=40
&QueueName=MyQueue
&Version=2012-11-05
&AUTHPARAMS
```
**nota**
Os nomes das filas e as URLs filas diferenciam maiúsculas de minúsculas.
A estrutura de *`AUTHPARAMS`* depende de como você assina sua solicitação de API. Para obter mais informações, consulte [Assinar solicitações de AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) na *Referência geral da Amazon Web Services*.
## Como fazer uma solicitação GET
Uma solicitação GET do Amazon SQS é estruturada como um URL que consiste no seguinte:
+ **Endpoint**: o recurso no qual a solicitação está agindo (o [nome da fila e o URL](sqs-queue-message-identifiers.md#queue-name-url)), por exemplo: `https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue`
+ **Ação**: a [ação](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html) que você quer executar no endpoint. Um ponto de interrogação (`?`) separa o endpoint da ação, por exemplo: `?Action=SendMessage&MessageBody=Your%20Message%20Text`
+ **Parâmetros**: os parâmetros da solicitação. Cada parâmetro é separado por um E comercial (`&`); por exemplo: `&Version=2012-11-05&AUTHPARAMS`
Veja a seguir um exemplo de solicitação GET que envia mensagens a uma fila do Amazon SQS.
```
https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue
?Action=SendMessage&MessageBody=Your%20message%20text
&Version=2012-11-05
&AUTHPARAMS
```
**nota**
Os nomes das filas e as URLs filas diferenciam maiúsculas de minúsculas.
Como as solicitações GET são URLs, você deve codificar em URL todos os valores dos parâmetros. Como não é permitida a entrada de espaços URLs, cada espaço é codificado em URL como. `%20` O restante do exemplo não foi codificado no URL para facilitar a leitura.
## Como fazer uma solicitação POST
As solicitações POST do Amazon SQS enviam parâmetros de consulta como um formulário no corpo de uma solicitação HTTP.
Veja a seguir um exemplo de cabeçalho HTTP com `Content-Type` definido como `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
```
O cabeçalho é seguido por uma solicitação GET `[form-urlencoded](https://www.w3.org/MarkUp/html-spec/html-spec_8.html#SEC8.2)` que envia uma mensagem a uma fila do Amazon SQS. Cada parâmetro é separado por um E comercial (`&`).
```
Action=SendMessage
&MessageBody=Your+Message+Text
&Expires=2020-10-15T12%3A00%3A00Z
&Version=2012-11-05
&AUTHPARAMS
```
**nota**
Somente o cabeçalho HTTP `Content-Type` é obrigatório. O `AUTHPARAMS` é o mesmo para a solicitação GET.
Seu cliente HTTP pode adicionar outros itens à solicitação HTTP, de acordo com a versão do HTTP do cliente.