> ## Documentation Index
> Fetch the complete documentation index at: https://dev.tryno.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog e depreciação

> Como a API da Tryno evolui, o que consideramos uma mudança incompatível, e o que já foi ao ar.

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](https://tryno.io/api/openapi.json) e anunciadas aqui antes de
qualquer remoção.

<Note>
  Esta página cobre a **API**. Mudanças de produto — checkout, planos, entrega,
  notificações — vivem no
  [changelog do produto](https://tryno.io/changelog).
</Note>

## Mudanças

<Update label="2026-08-06" tags={["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.
</Update>

<Update label="2026-07-12" tags={["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 leitura**

  `GET /v1/me` · `GET /v1/members` · `GET /v1/members/{username}` ·
  `GET /v1/posts` · `GET /v1/events` · `GET /v1/orders`

  Envelope 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.

  **Escopos**

  `members:read` · `posts:read` · `events:read` · `orders:read` ·
  `community:read` *(reservado — nenhum endpoint o exige hoje)*

  **Eventos de webhook**

  `member.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.
</Update>

<Card title="Abra a referência →" icon="braces" href="/api-reference/overview" horizontal>
  Veja as operações, os schemas e os exemplos do contrato atual.
</Card>