April 30, 2026

A API Usetix: construa em cima da sua conta

Os webhooks são ótimos quando algo acontece. A nova API Usetix é para quando quer fazer algo acontecer.

Hoje lançamos uma API REST completa. Pode ler tudo na conta, eventos, bilhetes, encomendas, clientes, venues, performers, e criar ou atualizar a maior parte. Construa painéis internos, sincronize clientes com o CRM, automatize a configuração de eventos ou ligue dados de bilheteira a qualquer outra coisa que opere.

Como funciona em 30 segundos

Gere um token em Definições → Tokens de API no painel de administração. Escolha Read para analytics e exportações, ou Read + Write para integrações que alteram dados em seu nome. Depois aponte qualquer cliente HTTP para os mesmos URLs que visitaria no browser, pedindo simplesmente JSON:

curl -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  https://app.usetix.io/admin/events

É isto. Sem ID de conta no URL. Sem prefixo /v1/. O token transporta a conta e o URL é o mesmo que o browser usa: Accept: application/json muda a resposta.

O que há na V1

Leitura: acesso completo a:

Eventos (com FAQs e campos personalizados de checkout embutidos)
Bilhetes (standard e de grupo)
Encomendas (com linhas e estado de resgate)
Clientes (com histórico de encomendas e consentimento de marketing)
Venues
Performers
Memberships (a sua equipa)

Escrita: criar, atualizar ou eliminar:

Eventos, incluindo publicar / despublicar
Bilhetes standard e de grupo, incluindo arquivar / desarquivar
Venues
Performers (com biografias em rich text e uploads de imagem)
FAQs de eventos
Campos personalizados de checkout

Uploads de imagem bem feitos

Para imagens e outros ficheiros, use o fluxo de direct upload em dois passos do Active Storage:

POST dos metadados do ficheiro para /rails/active_storage/direct_uploads. Recebe de volta um signed_id e um URL de upload pré-assinado.
PUT dos bytes do ficheiro diretamente para esse URL. Não passam pelo Usetix.
Referencie o signed_id na chamada seguinte à API ({"image": "<signed_id>"}).

Ficheiros grandes não ocupam os nossos servidores. Os pequenos continuam a sentir-se instantâneos. O mesmo fluxo que a UI de admin usa internamente.

URLs sem versão

Vai notar que não há /v1/ no caminho. Seguimos aqui a abordagem do Basecamp: URLs limpos, sem proliferação de versões. Quando mudanças incompatíveis forem inevitáveis, e fazemos tudo para as evitar, os endpoints legados passam para um host separado com uma janela de 3 a 6 meses. Migra no seu calendário, não no nosso.

O que pode construir com isto

A API mais webhooks cobre a maioria dos padrões de integração que temos ouvido:

Painéis personalizados: puxe eventos, encomendas e receita para a sua ferramenta de analytics
Sincronização de CRM: quando uma encomenda chega (via webhook), enriqueça o contacto com o histórico completo do cliente (via API)
Configuração automatizada de eventos: scriptee a criação de eventos recorrentes ou importe de outra plataforma
Ferramentas de admin internas: construa um cliente fino alinhado com o fluxo da equipa sem esperar que nós entreguemos a funcionalidade
Edições em massa: ajuste preços de bilhetes, capacidades ou janelas de venda em muitos eventos de uma vez
Relatórios para a contabilidade: obtenha faturas de clientes, encomendas pagas e reembolsos na forma de que o sistema financeiro precisa

Experimente agora

A API está disponível para todas as contas Usetix. Gere um token em Definições → Tokens de API no painel de administração.

A documentação completa está em usetix.io/docs/api EN only, autenticação, cada endpoint, cada campo, com exemplos curl.

Dúvidas ou bloqueios? Escreva para support@usetix.io. Gostaríamos de saber o que constrói.