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

# Comece por aqui

> Entenda como a Tryno se encaixa na sua operação e escolha a forma mais simples de integrar seu sistema ou suas automações.

## O que é a Tryno

A **Tryno** é uma plataforma de comunidades online ("tribos"): feed, cursos,
eventos, desafios, vídeo, mensageria, gamificação e checkout, tudo dentro do
espaço de cada criador.

A plataforma é **API-first**: o app web, futuros clientes mobile e as
integrações de parceiros consomem exatamente os mesmos endpoints HTTP. Não
existe uma camada privada paralela — o que você vê na
[Referência da API](/api-reference/overview) é o produto inteiro.

<Frame caption="O feed de uma tribo na Tryno — o mesmo espaço que a Platform API v1 expõe em /v1/posts e /v1/members.">
  <img src="https://mintcdn.com/tryno/Js4__YjMMxSypN-k/images/tribe-feed-overview.png?fit=max&auto=format&n=Js4__YjMMxSypN-k&q=85&s=8b46b97062377a54e68d3e21cb8afd98" alt="Feed de uma tribo na Tryno, com posts, setup da tribo e ranking semanal" width="2880" height="1800" data-path="images/tribe-feed-overview.png" />
</Frame>

<Note>
  **Você não precisa integrar tudo de uma vez.** Comece pelo menor fluxo que
  resolve seu caso. É comum começar só pela leitura (`/v1`), entregar um link do
  produto ao usuário final e só depois adicionar webhooks.
</Note>

## As duas superfícies

Isto é a primeira coisa a entender, porque elas se autenticam de formas
diferentes e servem propósitos diferentes.

<CardGroup cols={2}>
  <Card title="Platform API v1" icon="key-round" href="/guides/api-keys">
    **É esta que você quer.** Superfície pública, estável e **somente leitura**,
    autenticada por chave de API (`tryno_sk_…`). Montada em `/api/v1`. Cada
    chave é escopada a **uma** tribo. É o que você usa em Zapier, n8n ou numa
    integração própria.
  </Card>

  <Card title="API da aplicação" icon="app-window">
    Todo o resto da referência (`/api/communities`, `/api/posts`, `/api/wallet`…).
    Autenticada por **cookie de sessão**, não por chave. É o que o app web
    consome. Está documentada por transparência — não é um contrato estável para
    terceiros, e pode mudar sem aviso.
  </Card>
</CardGroup>

<Warning>
  Uma chave `tryno_sk_…` **não** autentica a API da aplicação, e um cookie de
  sessão **não** autentica `/v1`. Não são intercambiáveis.
</Warning>

## Escolha como integrar

<CardGroup cols={2}>
  <Card title="API pública" icon="terminal" href="/guides/api-keys">
    Para o seu backend ler membros, posts, eventos e pedidos da tribo usando
    `/api/v1`.

    **Preparar a API →**
  </Card>

  <Card title="Webhooks" icon="webhook" href="/guides/webhooks">
    Para o seu sistema reagir a mudanças assíncronas sem consultar a Tryno o
    tempo todo.

    **Entender webhooks →**
  </Card>
</CardGroup>

## Antes de começar

* Tenha acesso de **dono ou administrador** da tribo que vai ser integrada.
* Crie uma chave por integração — Zapier, n8n, seu backend — nunca uma só para tudo.
* Conceda apenas os escopos que aquela integração realmente usa.
* Guarde a chave em variável de ambiente ou cofre de segredos, nunca no front-end.

## Primeiros passos recomendados

<Steps>
  <Step title="Crie sua API key">
    Em [Criar API key](/guides/api-keys), gere uma chave `tryno_sk_…` escopada à
    sua tribo com o mínimo de escopos necessário.
  </Step>

  <Step title="Valide a conexão com uma leitura">
    Chame `GET /v1/me` para confirmar a quem a chave pertence e quais escopos
    ela carrega, antes de construir em cima dela.
  </Step>

  <Step title="Implemente o menor fluxo útil">
    Consulte a [Referência da API](/api-reference/overview) para o contrato
    exato de cada endpoint antes de enviar tráfego real.
  </Step>

  <Step title="Prepare a operação">
    Trate os erros pelo campo `error.type`, respeite o teto de 120 req/min e
    adicione [webhooks](/guides/webhooks) quando o fluxo depender de mudanças
    assíncronas.
  </Step>
</Steps>

## URL base

```
https://tryno.io/api
```

Todos os caminhos desta documentação são relativos a essa base. A Platform API
v1, portanto, vive em `https://tryno.io/api/v1/…`.

## Primeira chamada

Depois de [criar uma chave](/guides/api-keys), confirme a quem ela pertence:

```bash theme={"system"}
curl https://tryno.io/api/v1/me \
  -H "Authorization: Bearer tryno_sk_..."
```

```json theme={"system"}
{
  "object": "api_key",
  "community": { "id": "…", "handle": "sua-tribo", "name": "Sua Tribo" },
  "scopes": ["members:read", "posts:read"]
}
```

`GET /v1/me` é o único endpoint de `/v1` que não exige escopo algum.

## Convenções

<CardGroup cols={2}>
  <Card title="Paginação" icon="list-ordered" href="/guides/pagination">
    `page`, `pageSize` e o envelope `{ object: "list", … }` com `hasMore`.
  </Card>

  <Card title="Erros e limites" icon="triangle-alert" href="/guides/errors">
    Os dois envelopes de erro, a tabela de status e o teto de 120 req/min.
  </Card>

  <Card title="Receitas" icon="workflow" href="/guides/recipes">
    Fluxos ponta a ponta: webhook entra, `/v1` enriquece, sua ferramenta recebe.
  </Card>
</CardGroup>

Além disso, em toda a API:

* **Dinheiro** é sempre **inteiro em centavos** (`amountCents`) acompanhado de
  uma moeda (`amountCurrency`, ex.: `BRL`). Nunca há ponto flutuante em dinheiro
  na Tryno. Divida por 100 apenas na hora de exibir.
* **Datas** são strings ISO-8601 em UTC. Eventos também carregam o campo
  `timezone` da tribo, para exibição.

## O que a v1 **não** faz

Dito de forma direta, para você não planejar em cima do que não existe:

* **É somente leitura.** Não há `POST`/`PATCH`/`DELETE` em `/v1`. Um criador
  entrega essas chaves a terceiros; escrita entra quando houver um modelo de
  permissão à altura disso.
* **Não expõe conteúdo restrito.** `/v1/posts` devolve apenas posts publicados e
  **públicos**. Corpos de posts exclusivos de membros ou pagos nunca saem por
  uma chave.
* **Não atravessa tribos.** Uma chave vê exatamente uma tribo. Para várias
  tribos, use várias chaves.
* **Não tem SDK oficial ainda.** É HTTP + JSON; qualquer cliente serve.

<Card title="Próximo passo — crie sua primeira API key →" icon="key-round" href="/guides/api-keys" horizontal>
  Veja o passo a passo na tela de administração da tribo e escolha as permissões
  corretas para a sua integração.
</Card>