

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á.

# Interpretar as respostas da API JSON do Amazon SQS
<a name="sqs-json-api-responses"></a>

Quando você envia uma solicitação para o Amazon SQS, ela retorna uma resposta JSON com os resultados. A estrutura de resposta depende da ação da API que você usou.

Para entender os detalhes dessas respostas, consulte:
+ A ação específica da API nas [ações da API](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html) na *Referência de API do Amazon Simple Queue Service*
+ A [Protocolo Amazon SQS JSON AWS FAQs](sqs-json-faqs.md)

## Estrutura de resposta JSON bem-sucedida
<a name="sqs-json-api-successful-response-structure"></a>

Se a solicitação for bem-sucedida, o principal elemento de resposta será `x-amzn-RequestId`, que contém o identificador único universal (UUID) da solicitação, bem como outros campos de resposta anexados. Por exemplo, a resposta [`CreateQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html) a seguir contém o campo `QueueUrl`, que, por sua vez, contém o URL da fila criada.

```
HTTP/1.1 200 OK
x-amzn-RequestId: <requestId>
Content-Length: <PayloadSizeBytes>
Date: <Date>
Content-Type: application/x-amz-json-1.0
{
    "QueueUrl":"https://sqs.us-east-1.amazonaws.com/111122223333/MyQueue"
}
```

## Estrutura de resposta de erro JSON
<a name="sqs-api-error-response-structure"></a>

Se uma solicitação não for bem-sucedida, o Amazon SQS retornará a resposta principal, incluindo o cabeçalho HTTP e o corpo.

No cabeçalho HTTP, `x-amzn-RequestId` contém o UUID da solicitação. `x-amzn-query-error` contém duas informações: o tipo de erro e se o erro foi do produtor ou do consumidor. 

No corpo de resposta, `"__type"` indica outros detalhes do erro, e `Message` indica a condição de erro em um formato legível. 

Veja a seguir um exemplo de resposta de erro no formato JSON:

```
HTTP/1.1 400 Bad Request
x-amzn-RequestId: 66916324-67ca-54bb-a410-3f567a7a0571
x-amzn-query-error: AWS.SimpleQueueService.NonExistentQueue;Sender
Content-Length: <PayloadSizeBytes>
Date: <Date>
Content-Type: application/x-amz-json-1.0
{
    "__type": "com.amazonaws.sqs#QueueDoesNotExist",
    "message": "The specified queue does not exist."
}
```