Queue - Webhook Entradas

Endpoint para crear objetos en la cola de procesamiento relacionados con webhooks de entradas.

📥 Collection Postman

Descargar Collection - Queue Integration

URLs

Método	URL	Acción	Descripción
POST	/api/v1/integration/queue	Registrar	Crea un objeto en la cola de procesamiento para webhook de entradas
GET	/api/v1/integration/queue/{id}	Visualizar	Verifica el estado de procesamiento de un objeto en la cola

Producción:

{connect-producao}/api/v1/integration/queue

Homologación:

{connect-homologacao}/api/v1/integration/queue

Autenticación

Todas las solicitudes requieren un token de acceso obtenido en el endpoint de Security. El token debe ser enviado en el header AccessToken.

Crear Objeto en la Cola

Solicitud

Endpoint: POST {connect-producao}/api/v1/integration/queue

Headers:

AccessToken: {access_token}
Content-Type: application/json

Body:

{
  "action": "ticket-create",
  "data": {
    "datos_del_boleto": "valor",
    "datos_del_comprador": "valor"
  }
}

Respuesta de Éxito

Estado: 201 Created

{
  "id": "uuid-del-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Objeto creado con éxito",
  "processDate": null,
  "processStatus": "pending",
  "processMsg": null
}

Verificar Procesamiento

Solicitud

Endpoint: GET {connect-producao}/api/v1/integration/queue/{id}

Headers:

AccessToken: {access_token}

Respuesta de Éxito

Estado: 200 OK

{
  "id": "uuid-del-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Procesado con éxito",
  "processDate": "2025-01-01T00:05:00Z",
  "processStatus": "completed",
  "processMsg": "Procesamiento concluido",
  "msg": {
    "action": "ticket-create",
    "data": {
      "datos_del_boleto": "valor",
      "datos_del_comprador": "valor"
    }
  }
}

Campos de la Respuesta

Campo	Tipo	Descripción
id	string	Identificador único del objeto en la cola
created	datetime	Fecha de creación del objeto
iCode	number	Código de estado interno
iMsg	string	Mensaje de estado interno
processDate	datetime/null	Fecha de procesamiento (null si aún no procesado)
processStatus	string	Estado del procesamiento (pending, processing, completed, failed)
processMsg	string/null	Mensaje de procesamiento
msg	object	Datos originales de la solicitud

Ejemplo de Implementación

async function crearWebhookEntrada(datosEntrada, accessToken) {
  const response = await fetch('{connect-producao}/api/v1/integration/queue', {
    method: 'POST',
    headers: {
      'AccessToken': accessToken,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      action: 'ticket-create',
      data: datosEntrada
    })
  });

  if (!response.ok) {
    throw new Error(`Error ${response.status}: ${response.statusText}`);
  }

  const resultado = await response.json();
  return resultado.id;
}

async function verificarProcesamiento(queueId, accessToken) {
  const response = await fetch(`{connect-producao}/api/v1/integration/queue/${queueId}`, {
    method: 'GET',
    headers: {
      'AccessToken': accessToken
    }
  });

  if (!response.ok) {
    throw new Error(`Error ${response.status}: ${response.statusText}`);
  }

  return await response.json();
}