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 é o produto inteiro.
O feed de uma tribo na Tryno — o mesmo espaço que a Platform API v1 expõe em /v1/posts e /v1/members.
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.As duas superfícies
Isto é a primeira coisa a entender, porque elas se autenticam de formas diferentes e servem propósitos diferentes.Platform API v1
É 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.API da aplicação
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.Escolha como integrar
API pública
Para o seu backend ler membros, posts, eventos e pedidos da tribo usando
/api/v1.Preparar a API →Webhooks
Para o seu sistema reagir a mudanças assíncronas sem consultar a Tryno o
tempo todo.Entender webhooks →
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
1
Crie sua API key
Em Criar API key, gere uma chave
tryno_sk_… escopada à
sua tribo com o mínimo de escopos necessário.2
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.3
Implemente o menor fluxo útil
Consulte a Referência da API para o contrato
exato de cada endpoint antes de enviar tráfego real.
4
Prepare a operação
Trate os erros pelo campo
error.type, respeite o teto de 120 req/min e
adicione webhooks quando o fluxo depender de mudanças
assíncronas.URL base
https://tryno.io/api/v1/….
Primeira chamada
Depois de criar uma chave, confirme a quem ela pertence:GET /v1/me é o único endpoint de /v1 que não exige escopo algum.
Convenções
Paginação
page, pageSize e o envelope { object: "list", … } com hasMore.Erros e limites
Os dois envelopes de erro, a tabela de status e o teto de 120 req/min.
Receitas
Fluxos ponta a ponta: webhook entra,
/v1 enriquece, sua ferramenta recebe.- 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
timezoneda 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/DELETEem/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/postsdevolve 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.
Próximo passo — crie sua primeira API key →
Veja o passo a passo na tela de administração da tribo e escolha as permissões
corretas para a sua integração.