Queue - Webhook Ingressos

Endpoint para criar objetos na fila de processamento relacionados a webhooks de ingressos.

📥 Collection Postman

Baixar Collection - Queue Integration

URLs

Método	URL	Ação	Descrição
POST	/api/v1/integration/queue	Cadastrar	Cria um objeto na fila de processamento para webhook de ingressos
GET	/api/v1/integration/queue/{id}	Visualizar	Verifica o status de processamento de um objeto na fila

Produção:

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

Homologação:

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

Autenticação

Todas as requisições requerem um token de acesso obtido no endpoint de Security. O token deve ser enviado no header AccessToken.

Criar Objeto na Fila

Requisição

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

Headers:

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

Body:

{
  "action": "ticket-create",
  "data": {
    "dados_do_ingresso": "valor",
    "dados_do_comprador": "valor"
  }
}

Resposta de Sucesso

Status: 201 Created

{
  "id": "uuid-do-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Objeto criado com sucesso",
  "processDate": null,
  "processStatus": "pending",
  "processMsg": null
}

Verificar Processamento

Requisição

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

Headers:

AccessToken: {access_token}

Resposta de Sucesso

Status: 200 OK

{
  "id": "uuid-do-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Processado com sucesso",
  "processDate": "2025-01-01T00:05:00Z",
  "processStatus": "completed",
  "processMsg": "Processamento concluído",
  "msg": {
    "action": "ticket-create",
    "data": {
      "dados_do_ingresso": "valor",
      "dados_do_comprador": "valor"
    }
  }
}

Campos da Resposta

Campo	Tipo	Descrição
id	string	Identificador único do objeto na fila
created	datetime	Data de criação do objeto
iCode	number	Código de status interno
iMsg	string	Mensagem de status interno
processDate	datetime/null	Data de processamento (null se ainda não processado)
processStatus	string	Status do processamento (pending, processing, completed, failed)
processMsg	string/null	Mensagem de processamento
msg	object	Dados originais da requisição

Exemplo de Implementação

async function criarWebhookIngresso(dadosIngresso, 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: dadosIngresso
    })
  });

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

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

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

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

  return await response.json();
}