May 03, 2026

Incorpore os eventos em qualquer sítio: um feed JSON público para cada loja

Os seus eventos sempre viveram na loja Usetix. Hoje vivem também em qualquer outro site onde os queira.

Cada evento publicado na loja está agora disponível como JSON no mesmo URL: basta acrescentar .json (ou enviar Accept: application/json). Sem token, sem registo, sem proxy. Ponha umas linhas de JavaScript no site da banda, no hub do festival ou na listagem de um parceiro, e o line-up completo aparece lá, automaticamente.

O que obtém

curl -H "Accept: application/json" \
  https://your-subdomain.usetix.io/events

Devolve os eventos publicados e futuros com tudo o que uma página de terceiros precisa para os renderizar: título, datas, venue (com lat/lng para mapas), imagens, flag de esgotado, preço mais baixo disponível e um URL de compra direto.

GET /events/spring-showcase.json acrescenta bilhetes, performers e FAQ para um único evento.

É isto. Dois endpoints, públicos, sem auth.

Feito para incorporar

Algumas decisões embutidas:

CORS aberto a todas as origins. Faça fetch de qualquer browser, de qualquer domínio.
Cache-Control: public, max-age=60: o CDN, o reverse proxy, até o browser do visitante, guardam em cache durante um minuto.
ETag no detalhe do evento: pedidos repetidos devolvem 304 Not Modified e corpo vazio quando nada mudou.
URLs de imagem absolutos: use-os diretamente em <img src=...> a partir de qualquer origin.
Dinheiro como { amount, currency }: a mesma forma que o resto da API, sem símbolos, sem floats.

<div id="next-event"></div>

<script>
  fetch("https://your-subdomain.usetix.io/events.json")
    .then(r => r.json())
    .then(data => {
      const next = data.events[0];
      if (!next) return;
      document.getElementById("next-event").innerHTML = `
        <a href="${next.url}">
          <img src="${next.image_url}" alt="">
          <h3>${next.title}</h3>
          <p>${new Date(next.starts_at).toLocaleString()} · ${next.venue.name}</p>
        </a>`;
    });
</script>

Ponha isto no WordPress da banda, no Squarespace do venue, na landing estática do festival. Atualiza-se da próxima vez que um visitante carregar a página e, no momento em que publicar um novo evento no Usetix, está lá.

O que não está no feed

O feed público expõe apenas o que a loja já mostra publicamente. Rascunhos, bilhetes ocultos sem código de acesso, números de capacidade, stock de bilhetes, dados de clientes, dados de encomendas, nada disso está lá. Para tudo isso, mais escrita completa, use a API de admin autenticada EN only.

Experimente

Publique um evento na conta e peça o slug em JSON:

curl https://your-subdomain.usetix.io/events.json

A referência completa, cada campo, cada endpoint, com exemplos de incorporação, está em usetix.io/docs/api/public-events EN only.

Construiu algo fixe com isto? Conte-nos em support@usetix.io.

O que obtém

Feito para incorporar

Um widget «próximo evento» em 10 linhas

O que não está no feed

Experimente