Vendas de ingressos por hora

Endpoint: GET /event/seller/{account_id}/events/metrics/ticketsalesbyhour/

Autenticação: JWT obrigatório ou Chave de API aceita.

Retorna a contagem de ingressos vendidos agrupada por hora do dia (0–23), somando todas as datas que casarem com o filtro. Internamente, a métrica pré-agregada por hora é carregada para a conta e o período, e então reduzida por hour no servidor — a resposta é uma lista plana, não paginada e sem envelope por data. É a fonte que alimenta o gráfico de “em que horário as pessoas compram ingressos?”. As horas são calculadas no fuso horário do servidor (mesmo das demais métricas de evento).

Pré-requisitos

O autenticado precisa operar a conta {account_id}.

Parâmetros de path

string (uuid)

required

Parâmetros de query

string (date)

Limite inferior (inclusivo), no formato YYYY-MM-DD.

string (date)

Limite superior (inclusivo), no formato YYYY-MM-DD.

Resposta

200 OK com um array plano de objetos {hour, total}. A ordem segue a iteração interna; os clientes devem reordenar por hour se precisarem. Horas sem vendas são omitidas.

integer

De 0 a 23.

integer

Ingressos vendidos durante aquela hora, somando todo o período filtrado.

[
  {"hour": 9, "total": 12},
  {"hour": 14, "total": 38},
  {"hour": 22, "total": 91}
]

Erros

Status	Quando
`401`	Token ausente ou inválido.

Exemplos

curl "https://api.dlpay.cloud/event/seller/$ACCOUNT_ID/events/metrics/ticketsalesbyhour/?date_after=2026-04-01&date_before=2026-05-14" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/event/seller/{account_id}/events/metrics/ticketsalesbyhour/",
    headers={"Authorization": f"Bearer {access_token}"},
    params={"date_after": "2026-04-01", "date_before": "2026-05-14"},
)
buckets = response.json()

const url = new URL(
  `https://api.dlpay.cloud/event/seller/${accountId}/events/metrics/ticketsalesbyhour/`,
);
url.searchParams.set("date_after", "2026-04-01");
url.searchParams.set("date_before", "2026-05-14");
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const buckets = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Vendas de ingressos por hora

Pré-requisitos

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de path

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos