curl --request POST \
--url https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"body": "{\"order_id\":\"A-1001\"}",
"attributes": {
"severity": {
"type": "String",
"value": "critical"
},
"attempt": {
"type": "Number",
"value": "2"
}
},
"delay_seconds": 0,
"message_group_id": "customer-42",
"message_deduplication_id": "order-A-1001"
}
'import requests
url = "https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages"
payload = {
"body": "{\"order_id\":\"A-1001\"}",
"attributes": {
"severity": {
"type": "String",
"value": "critical"
},
"attempt": {
"type": "Number",
"value": "2"
}
},
"delay_seconds": 0,
"message_group_id": "customer-42",
"message_deduplication_id": "order-A-1001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
body: JSON.stringify('{"order_id":"A-1001"}'),
attributes: {
severity: {type: 'String', value: 'critical'},
attempt: {type: 'Number', value: '2'}
},
delay_seconds: 0,
message_group_id: 'customer-42',
message_deduplication_id: 'order-A-1001'
})
};
fetch('https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'body' => '{"order_id":"A-1001"}',
'attributes' => [
'severity' => [
'type' => 'String',
'value' => 'critical'
],
'attempt' => [
'type' => 'Number',
'value' => '2'
]
],
'delay_seconds' => 0,
'message_group_id' => 'customer-42',
'message_deduplication_id' => 'order-A-1001'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages"
payload := strings.NewReader("{\n \"body\": \"{\\\"order_id\\\":\\\"A-1001\\\"}\",\n \"attributes\": {\n \"severity\": {\n \"type\": \"String\",\n \"value\": \"critical\"\n },\n \"attempt\": {\n \"type\": \"Number\",\n \"value\": \"2\"\n }\n },\n \"delay_seconds\": 0,\n \"message_group_id\": \"customer-42\",\n \"message_deduplication_id\": \"order-A-1001\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"body\": \"{\\\"order_id\\\":\\\"A-1001\\\"}\",\n \"attributes\": {\n \"severity\": {\n \"type\": \"String\",\n \"value\": \"critical\"\n },\n \"attempt\": {\n \"type\": \"Number\",\n \"value\": \"2\"\n }\n },\n \"delay_seconds\": 0,\n \"message_group_id\": \"customer-42\",\n \"message_deduplication_id\": \"order-A-1001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"body\": \"{\\\"order_id\\\":\\\"A-1001\\\"}\",\n \"attributes\": {\n \"severity\": {\n \"type\": \"String\",\n \"value\": \"critical\"\n },\n \"attempt\": {\n \"type\": \"Number\",\n \"value\": \"2\"\n }\n },\n \"delay_seconds\": 0,\n \"message_group_id\": \"customer-42\",\n \"message_deduplication_id\": \"order-A-1001\"\n}"
response = http.request(request)
puts response.read_body{
"result": {
"message_id": "019400aa-bbbb-7ccc-8ddd-eeeeffff0000",
"duplicate": false
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"instances": 2,
"pools": 0
}
}
}Enviar un mensaje
curl --request POST \
--url https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"body": "{\"order_id\":\"A-1001\"}",
"attributes": {
"severity": {
"type": "String",
"value": "critical"
},
"attempt": {
"type": "Number",
"value": "2"
}
},
"delay_seconds": 0,
"message_group_id": "customer-42",
"message_deduplication_id": "order-A-1001"
}
'import requests
url = "https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages"
payload = {
"body": "{\"order_id\":\"A-1001\"}",
"attributes": {
"severity": {
"type": "String",
"value": "critical"
},
"attempt": {
"type": "Number",
"value": "2"
}
},
"delay_seconds": 0,
"message_group_id": "customer-42",
"message_deduplication_id": "order-A-1001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
body: JSON.stringify('{"order_id":"A-1001"}'),
attributes: {
severity: {type: 'String', value: 'critical'},
attempt: {type: 'Number', value: '2'}
},
delay_seconds: 0,
message_group_id: 'customer-42',
message_deduplication_id: 'order-A-1001'
})
};
fetch('https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'body' => '{"order_id":"A-1001"}',
'attributes' => [
'severity' => [
'type' => 'String',
'value' => 'critical'
],
'attempt' => [
'type' => 'Number',
'value' => '2'
]
],
'delay_seconds' => 0,
'message_group_id' => 'customer-42',
'message_deduplication_id' => 'order-A-1001'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages"
payload := strings.NewReader("{\n \"body\": \"{\\\"order_id\\\":\\\"A-1001\\\"}\",\n \"attributes\": {\n \"severity\": {\n \"type\": \"String\",\n \"value\": \"critical\"\n },\n \"attempt\": {\n \"type\": \"Number\",\n \"value\": \"2\"\n }\n },\n \"delay_seconds\": 0,\n \"message_group_id\": \"customer-42\",\n \"message_deduplication_id\": \"order-A-1001\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"body\": \"{\\\"order_id\\\":\\\"A-1001\\\"}\",\n \"attributes\": {\n \"severity\": {\n \"type\": \"String\",\n \"value\": \"critical\"\n },\n \"attempt\": {\n \"type\": \"Number\",\n \"value\": \"2\"\n }\n },\n \"delay_seconds\": 0,\n \"message_group_id\": \"customer-42\",\n \"message_deduplication_id\": \"order-A-1001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://queue.{region}.basaltic.sh/v1/queues/{queue_id}/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"body\": \"{\\\"order_id\\\":\\\"A-1001\\\"}\",\n \"attributes\": {\n \"severity\": {\n \"type\": \"String\",\n \"value\": \"critical\"\n },\n \"attempt\": {\n \"type\": \"Number\",\n \"value\": \"2\"\n }\n },\n \"delay_seconds\": 0,\n \"message_group_id\": \"customer-42\",\n \"message_deduplication_id\": \"order-A-1001\"\n}"
response = http.request(request)
puts response.read_body{
"result": {
"message_id": "019400aa-bbbb-7ccc-8ddd-eeeeffff0000",
"duplicate": false
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"instances": 2,
"pools": 0
}
}
}queue:SendMessage. Consulte QUEUE permisos para la lista completa, el alcance de cada acción y un ejemplo de política.Autorizaciones
Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. 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.
Parámetros de ruta
"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
Cuerpo
Contenido del mensaje. Se suma a los atributos en el límite max_message_bytes de la cola.
"{\"order_id\":\"A-1001\"}"
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.
Show child attributes
Show child attributes
{
"severity": { "type": "String", "value": "critical" },
"attempt": { "type": "Number", "value": "2" }
}
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.
0 <= x <= 9000
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.
128"customer-42"
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.
128"order-A-1001"
Respuesta
Mensaje encolado. En FIFO, una entrada de deduplicación activa mantiene el envío correcto, con duplicate true y el ID del mensaje original.
Show child attributes
Show child attributes

