> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Enviar hasta diez mensajes
> Informa el resultado de cada entrada: un mensaje demasiado grande no impide los demás. Devuelve 200 cuando la solicitud se ha procesado; compruebe el resultado de cada mensaje.
Requiere la acción IAM **`queue:SendMessage`**. Consulte [QUEUE permisos](/es/queue/permissions) para la lista completa, el alcance de cada acción y un ejemplo de política.
## OpenAPI
````yaml /es/api-reference/specs/queue.yaml post /v1/queues/{queue_id}/messages/batch
openapi: 3.0.3
info:
title: API Basaltic Queue
version: 1.0.0
description: >-
Colas duraderas con entrega al menos una vez. Recibir un mensaje concede una
reserva temporal: `ReceiveMessage` lo oculta durante el timeout de
visibilidad y devuelve un recibo. Elimine el mensaje con ese recibo antes de
que venza para evitar la reentrega. Cada recepción genera un recibo nuevo;
los recibos vencidos devuelven `QUEUE_RECEIPT_HANDLE_EXPIRED`.
Las colas estándar tienen orden de mejor esfuerzo. Las colas FIFO terminan
en `.fifo`, mantienen el orden por `message_group_id` y deduplican
`message_deduplication_id` durante cinco minutos. Los grupos distintos
pueden procesarse en paralelo. El tipo es inmutable. `wait_time_seconds`
permite esperar hasta 20 segundos por mensajes.
Los cuerpos se cifran en reposo. `kms_key` acepta UUID, nombre en la cuenta
o CRN completo de una clave simétrica habilitada en la misma cuenta y
región. Las referencias inválidas devuelven 400; las claves inexistentes
devuelven 404. Las lecturas de metadatos conservan ID y CRN de una
vinculación eliminada. La clave de datos permanece en caché durante
`kms_data_key_reuse_period_seconds`; los envíos y recepciones pueden
continuar durante esa ventana tras desactivar la clave. Reducirla aumenta
las llamadas a KMS.
contact:
name: Basaltic Support
email: ping@basaltic.sh
license:
name: Proprietary
url: https://basaltic.sh/terms
servers:
- url: https://queue.{region}.basaltic.sh
description: Punto final de API regional
variables:
region:
default: sa-saopaulo-1
description: Código de región
security:
- BearerAuth: []
tags:
- name: Queues
description: Ciclo de vida y atributos de las colas
- name: Messages
description: Envío, recepción y confirmación de mensajes
paths:
/v1/queues/{queue_id}/messages/batch:
parameters:
- $ref: '#/components/parameters/QueueId'
post:
tags:
- Messages
summary: Enviar hasta diez mensajes
description: >-
Informa el resultado de cada entrada: un mensaje demasiado grande no
impide los demás. Devuelve 200 cuando la solicitud se ha procesado;
compruebe el resultado de cada mensaje.
operationId: sendMessageBatch
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SendMessageBatchRequest'
responses:
'200':
description: Resultados por entrada.
content:
application/json:
schema:
$ref: '#/components/schemas/BatchResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
components:
parameters:
QueueId:
name: queue_id
in: path
required: true
schema:
type: string
format: uuid
example: a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
schemas:
SendMessageBatchRequest:
type: object
required:
- entries
properties:
entries:
type: array
minItems: 1
maxItems: 10
items:
allOf:
- type: object
required:
- id
properties:
id:
type: string
description: >-
Identificador propio de la entrada, repetido en el
resultado. Debe ser único en la solicitud.
example: e1
- $ref: '#/components/schemas/SendMessageRequest'
BatchResponse:
type: object
required:
- results
properties:
results:
type: array
items:
$ref: '#/components/schemas/BatchResult'
SendMessageRequest:
type: object
required:
- body
properties:
body:
type: string
description: >-
Contenido del mensaje. Se suma a los atributos en el límite
max_message_bytes de la cola.
example: '{"order_id":"A-1001"}'
attributes:
$ref: '#/components/schemas/MessageAttributes'
delay_seconds:
type: integer
minimum: 0
maximum: 900
description: >-
Sustituye el valor predeterminado de la cola solo en este mensaje.
Se rechaza en FIFO para no hacer visible un mensaje posterior antes
de otro del mismo grupo.
example: 0
message_group_id:
type: string
maxLength: 128
description: >-
Obligatorio en FIFO y rechazado en colas estándar. Los mensajes del
mismo grupo se entregan en orden; el siguiente espera mientras el
anterior está en proceso.
example: customer-42
message_deduplication_id:
type: string
maxLength: 128
description: >-
Solo FIFO. Una repetición en cinco minutos se suprime y devuelve el
ID original. Omítalo en colas con `content_based_deduplication` para
derivar el identificador del cuerpo.
example: order-A-1001
BatchResult:
type: object
required:
- id
properties:
id:
type: string
description: ID de la entrada en la solicitud.
example: e1
message_id:
type: string
format: uuid
example: 019400aa-bbbb-7ccc-8ddd-eeeeffff0000
duplicate:
type: boolean
example: false
error:
type: string
description: Código de error legible por máquina cuando esta entrada falló.
example: QUEUE_MESSAGE_TOO_LARGE
message:
type: string
description: Descripción legible del error.
example: message is 300000 bytes; this queue accepts 262144
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- request_id
properties:
code:
type: string
description: Código de error que identifica el tipo de error
example: INVALID_INPUT
message:
type: string
description: Mensaje de error legible por el ser humano
example: Invalid request parameters
params:
type: object
additionalProperties: true
description: >-
Valores no sensibles opcionales para la interpolación de errores
localizados, codificados por código de error. Nunca presente por
errores del servidor.
example:
instances: 2
pools: 0
request_id:
type: string
format: uuid
description: Solicitar ID para depuración
example: 550e8400-e29b-41d4-a716-446655440000
MessageAttributes:
type: object
description: >-
Atributos tipados enviados con el cuerpo. Hasta 20, con valores de hasta
1024 caracteres. Los valores `Binary` usan base64 estándar. La cola
valida el tipo declarado sin convertir valores.
additionalProperties:
type: object
required:
- type
- value
properties:
type:
type: string
enum:
- String
- Number
- Binary
example: String
value:
type: string
example: critical
example:
severity:
type: String
value: critical
attempt:
type: Number
value: '2'
responses:
BadRequest:
description: Parámetros de solicitud no válidos
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INVALID_INPUT
message: Invalid request parameters
request_id: 550e8400-e29b-41d4-a716-446655440000
Unauthorized:
description: Se requiere autenticación o el token no es válido
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: Authentication required
request_id: 550e8400-e29b-41d4-a716-446655440000
Forbidden:
description: Permisos insuficientes
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: ACCESS_DENIED
message: You don't have permission to perform this action
request_id: 550e8400-e29b-41d4-a716-446655440000
NotFound:
description: No se encontró el recurso
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: Resource not found
request_id: 550e8400-e29b-41d4-a716-446655440000
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >+
Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer
`. Esta es la forma recomendada de autenticación.
Obtén el token intercambiando el par de claves de acceso de una cuenta
de servicio en `POST /v1/oauth/token` con
`grant_type=client_credentials`. Es el flujo estándar de credenciales de
cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar
el token por ti.
```
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
```
Los tokens duran una hora por defecto. El mismo par de claves de acceso
también sirve como credencial AWS SigV4 para el endpoint de objetos
compatible con S3, que solo acepta ese método de autenticación.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.