

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Interprétation des réponses de l'API JSON Amazon SQS
<a name="sqs-json-api-responses"></a>

Lorsque vous envoyez une demande à Amazon SQS, celui-ci renvoie une réponse JSON avec les résultats. La structure de réponse dépend de l'action d'API que vous avez utilisée.

Pour comprendre le détail de ces réponses, voir :
+ L'action d'API spécifique dans les [actions d'API](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html) du manuel *Amazon Simple Queue Service API Reference*
+ La [Protocole JSON Amazon SQS AWS FAQs](sqs-json-faqs.md)

## Structure d'une réponse JSON positive
<a name="sqs-json-api-successful-response-structure"></a>

Si la demande aboutit, l'élément de réponse principal est `x-amzn-RequestId`, qui contient l'identifiant unique universel (UUID) de la demande, ainsi que d'autres champs de réponse ajoutés. Par exemple, la réponse [`CreateQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html) suivante contient le champ `QueueUrl`, qui contient à son tour l'URL de la file d'attente créée.

```
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"
}
```

## Structure d'une réponse d'erreur JSON
<a name="sqs-api-error-response-structure"></a>

Si une demande échoue, Amazon SQS renvoie la réponse principale, y compris l'en-tête HTTP et le corps du message.

Dans l'en-tête HTTP, `x-amzn-RequestId` contient l'UUID de la demande. `x-amzn-query-error` contient deux informations : le type d'erreur et s'il s'agit d'une erreur du producteur ou du consommateur. 

Dans le corps de la réponse, `"__type"` indique les autres détails de l'erreur et `Message` indique la condition d'erreur dans un format lisible. 

Vous trouverez ci-dessous un exemple de réponse d'erreur au format 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."
}
```