Skip to main content
Dentro da v1, mudanças são aditivas. Alterações incompatíveis exigem uma nova versão de path e uma migração explícita.

​
Política de compatibilidade

Clientes devem tolerar novos campos opcionais aparecendo numa resposta sem quebrar. Em contrapartida, dentro de /api/v1 nós não removemos nem renomeamos campos, e não mudamos a semântica de um campo existente em silêncio. O que não é considerado uma mudança incompatível:
  • Um campo opcional novo numa resposta.
  • Um valor novo num campo que já era aberto (por exemplo, um novo tipo de post).
  • Um endpoint novo.
O que é, e portanto exigiria /api/v2:
  • Remover ou renomear um campo.
  • Mudar o tipo ou o significado de um campo existente.
  • Apertar uma validação de forma que uma chamada antes válida passe a falhar.
Depreciações, quando existirem, são marcadas primeiro no contrato OpenAPI e anunciadas aqui antes de qualquer remoção.
Esta página cobre a API. Mudanças de produto — checkout, planos, entrega, notificações — vivem no changelog do produto.

​
Mudanças

​
docs

​
Documentação para desenvolvedores

Publicação desta documentação: guias de API key, webhooks, paginação, erros e receitas de integração, mais a Referência da API gerada a partir do contrato OpenAPI servido em /api/openapi.json — o mesmo contrato que o produto expõe, não uma cópia mantida à mão.Destaques desta edição: verificação de assinatura de webhook em Node, Python e Go (com a ressalva do corpo bruto), procedimento de rotação de chaves com janela de sobreposição, cliente de retentativa com backoff exponencial e jitter, e o laço completo de varredura paginada.Nenhuma mudança de comportamento na API acompanha esta entrada.
​
v1

​
Platform API v1 e webhooks de saída

Primeira superfície pública da Tryno: chaves de API por criador (tryno_sk_…), escopadas a uma tribo, montadas em /api/v1, somente leitura — e entrega de eventos por webhook assinada com HMAC-SHA256.Endpoints de leituraGET /v1/me · GET /v1/members · GET /v1/members/{username} · GET /v1/posts · GET /v1/events · GET /v1/ordersEnvelope de lista { object: "list", data, page, pageSize, hasMore }, paginação por page/pageSize (padrão 25, máximo 100), erros tipados (unauthorized, forbidden, not_found, rate_limited) e teto de 120 requisições por minuto por chave.Escoposmembers:read · posts:read · events:read · orders:read · community:read (reservado — nenhum endpoint o exige hoje)Eventos de webhookmember.joined · member.left · member.removed · order.paid · post.created · win.approved · event.created, mais o evento de teste ping. Assinatura x-tryno-signature: t=…,v1=…, seis tentativas com backoff de 1m / 5m / 30m / 2h / 6h.

Abra a referência →

Veja as operações, os schemas e os exemplos do contrato atual.