Teodosius API v1.0.0
API REST multi-tenant para gestão de clientes, serviços e recursos. Construída com Next.js 16, Supabase e TypeScript.
📋 Índice
- Características
- Configuração
- Instalação
- Autenticação
- Endpoints
- Schemas de Dados
- Paginação
- Tratamento de Erros
- RBAC e Permissões
- Webhooks
- Exemplos de Uso
- Deploy
✨ Características
- ✅ Autenticação JWT com API Keys (app_code + secret)
- ✅ Autorização baseada em roles (RBAC - Role-Based Access Control)
- ✅ Multi-tenant (suporte a múltiplas organizações)
- ✅ CORS configurado para origens seguras
- ✅ Tratamento de erros padronizado com códigos específicos
- ✅ Validação de dados com Zod schemas
- ✅ Paginação automática em endpoints de listagem
- ✅ Idempotência para webhooks
- ✅ Logging estruturado com Pino
- ✅ Request-ID para rastreamento de requisições
- ✅ ETag support para cache condicional
- ✅ OpenAPI schema disponível
Base URL
Produção:
https://api.teodosius.com/api/v1Desenvolvimento:
http://localhost:3000/api/v1