Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Realizar solicitudes de API de consulta mediante el protocolo AWS JSON en Amazon SQS
<a name="sqs-making-api-requests-json"></a>

En este tema se explica cómo crear un punto de conexión de Amazon SQS, realizar solicitudes POST e interpretar las respuestas.

**nota**  
AWS El protocolo JSON es compatible con la mayoría de las variantes de idioma. Para ver una lista completa de las variantes de lenguaje admitidas, consulte [¿Qué idiomas son compatibles con el protocolo AWS JSON que se utiliza en Amazon SQS? APIs](sqs-json-faqs.md#json-protocol-supported-languages).

## Construcción de un punto de enlace
<a name="sqs-api-constructing-endpoints-json"></a>

Para trabajar con colas de Amazon SQS, debe crear un punto de conexión. Para obtener información sobre los puntos de conexión de Amazon SQS, consulte las páginas siguientes en *Referencia general de Amazon Web Services*:
+ [Puntos de conexión regionales](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)
+ [Puntos de conexión y cuotas de Amazon Simple Queue Service](https://docs.aws.amazon.com/general/latest/gr/sqs-service)

Cada punto de conexión de Amazon SQS es independiente. Por ejemplo, si dos colas se denominan *MyQueue* y una tiene el punto de enlace `sqs.us-east-2.amazonaws.com` mientras que la otra tiene el punto de enlace `sqs.eu-west-2.amazonaws.com`, no comparten ningún dato entre ellas.

A continuación, se muestra un ejemplo de un punto de conexión que realiza una solicitud para crear una cola. 

```
POST / HTTP/1.1
Host: sqs.us-west-2.amazonaws.com
X-Amz-Target: AmazonSQS.CreateQueue
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive 
{
    "QueueName":"MyQueue",
    "Attributes": {
        "VisibilityTimeout": "40"
    },
    "tags": {
        "QueueType": "Production"
    }
}
```

**nota**  
Los nombres de las colas y las colas URLs distinguen mayúsculas de minúsculas.  
La estructura de {{`AUTHPARAMS`}} depende de la firma de la solicitud de API. Para obtener más información, consulte [Firmar solicitudes de AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) en la *Referencia general de Amazon Web Services*.

## Realizar una solicitud POST
<a name="structure-post-request"></a>

Las solicitudes POST de Amazon SQS envían parámetros de consulta como un formulario en el cuerpo de una solicitud HTTP.

A continuación, se muestra un ejemplo de un encabezado HTTP con `X-Amz-Target` establecido a `AmazonSQS.<operationName>` y de un encabezado HTTP con `Content-Type` establecido a `application/x-amz-json-1.0`.

```
POST / HTTP/1.1
Host: sqs.<region>.<domain>
X-Amz-Target: AmazonSQS.SendMessage
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive 
{
    "QueueUrl": "https://sqs.<region>.<domain>/<awsAccountId>/<queueName>/",
    "MessageBody": "This is a test message"
}
```

Esta solicitud HTTP POST envía un mensaje a una cola de Amazon SQS.

**nota**  
Ambos encabezados HTTP `X-Amz-Target` y `Content-Type` son obligatorios.  
El cliente HTTP puede añadir otros elementos a la solicitud HTTP, según la versión de HTTP del cliente.