API
Tribos (Communities)
Endpoints para criar, listar, atualizar e gerenciar suas comunidades pagas.
Tribos (Communities)
Comunidades (tribos) são a unidade central do OctaLife. Cada tribo tem tiers de assinatura, feed, membros, treinos e desafios próprios.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
GET | /api/v1/communities | Listar tribos do creator |
POST | /api/v1/communities | Criar nova tribo |
GET | /api/v1/communities/:id | Buscar tribo por ID |
PATCH | /api/v1/communities/:id | Atualizar tribo |
DELETE | /api/v1/communities/:id | Pausar tribo (soft delete) |
Listar tribos
curl -X GET https://app.octalife.ai/api/v1/communities \
-H "Authorization: Bearer ol_live_sua_chave"Resposta:
{
"success": true,
"data": [
{
"id": "uuid",
"name": "Elite Training",
"slug": "elite-training",
"description": "Hipertrofia e força.",
"category": "musculacao",
"is_public": true,
"members_count": 412,
"active_subscribers": 348,
"mrr_cents": 1872000,
"created_at": "2025-12-01T10:00:00Z"
}
]
}Criar tribo
curl -X POST https://app.octalife.ai/api/v1/communities \
-H "Authorization: Bearer ol_live_sua_chave" \
-H "Content-Type: application/json" \
-d '{
"name": "Elite Training",
"slug": "elite-training",
"description": "Hipertrofia e força.",
"category": "musculacao",
"is_public": true,
"cover_image_url": "https://..."
}'Campos
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome público da tribo |
slug | string | Sim | URL única (a-z0-9-) |
description | string | Não | Descrição curta |
category | enum | Sim | musculacao, funcional, yoga, crossfit, corrida, nutricao, outros |
is_public | boolean | Não (true) | Se aparece no /descubra |
cover_image_url | string | Não | URL da capa |
O slug é imutável após criação. Mudar exige criar nova tribo.
Atualizar tribo
curl -X PATCH https://app.octalife.ai/api/v1/communities/uuid \
-H "Authorization: Bearer ol_live_sua_chave" \
-H "Content-Type: application/json" \
-d '{ "description": "Nova descrição." }'Pausar tribo
DELETE faz soft delete: assinaturas ativas são honradas até o fim do ciclo, mas novas inscrições ficam bloqueadas.
curl -X DELETE https://app.octalife.ai/api/v1/communities/uuid \
-H "Authorization: Bearer ol_live_sua_chave"