SubTrackr

Configurações

Gerencie suas preferências e dados do SubTrackr

Aparência

Personalize sua experiência no SubTrackr com temas bonitos

Idioma

Escolha o idioma da interface.

Exportar Dados

Baixe seus dados de assinaturas em vários formatos

Exportar como CSV Exportar como JSON

URL Base

Defina a URL externa da sua instância do SubTrackr. Usada para links de assinatura iCal e e-mails de redefinição de senha. Se deixado em branco, os links iCal são detectados pela requisição e os e-mails de redefinição contêm apenas um caminho para abrir no seu endereço do SubTrackr.

Assinatura de Calendário

Ative uma URL iCal para assinatura que aplicativos de calendário possam consultar para atualizações em tempo real

Assinatura iCal

Permitir que aplicativos de calendário se inscrevam nas suas datas de renovação

Adicione esta URL como "Assinar Calendário" no seu aplicativo de calendário (Google Agenda, Apple Calendar, Outlook, etc.)

Gerenciamento de Dados

Backup dos Dados

Crie um backup de todos os seus dados de assinaturas

Criar Backup

Restaurar Backup

Importe assinaturas de um arquivo de backup

Importar do Wallos

Importe suas assinaturas de um arquivo "Export to JSON" do Wallos. Novas categorias são criadas automaticamente.

Limpar Todos os Dados

Excluir permanentemente todos os dados de assinaturas

Notificações por E-mail

Configuração SMTP

Para este endereço serão enviados os e-mails de notificação

Lembretes de Renovação

Enviar notificações antes das renovações de assinatura

Alertas de Alto Custo

Alertar ao adicionar assinaturas caras

Limite de Alto Custo

Limite de custo mensal para alertas de alto custo (em R$)

R$

Dias Antes da Renovação

Valor padrão de dias de antecedência. Use o campo de múltiplas janelas abaixo para vários lembretes.

Janelas de Lembrete de Renovação

Dias antes da renovação separados por vírgula (ex.: 7,3,0). Um lembrete é enviado a cada limite cruzado. Deixe vazio para usar o valor único acima.

Lembretes de Cancelamento

Ser notificado antes do término das assinaturas

Dias Antes do Cancelamento

Valor padrão de dias de antecedência. Use o campo de múltiplas janelas abaixo para vários lembretes.

Janelas de Lembrete de Cancelamento

Dias antes do cancelamento separados por vírgula. Deixe vazio para usar o valor único acima.

Notificações Pushover

Receba notificações push no seu dispositivo móvel via Pushover

Configuração do Pushover

Obtenha sua Chave de Usuário em pushover.net

Crie um aplicativo em pushover.net/apps

Notificações por Webhook

Envie notificações para qualquer endpoint webhook (Slack, Discord, n8n, Home Assistant, etc.)

Notificações no Telegram

Receba notificações no Telegram via um bot

Configuração do Telegram

Crie um bot e obtenha um token em @BotFather

Encontre seu ID de Chat enviando uma mensagem para @userinfobot

Notificações ntfy

Receba notificações push via ntfy.sh ou seu próprio servidor ntfy

Configuração do ntfy

Deixe como https://ntfy.sh ou insira seu servidor auto-hospedado (http:// funciona na sua LAN)

Apenas letras, dígitos, - e _. Em servidores públicos o tópico funciona como senha, então escolha um difícil de adivinhar

Necessário apenas para tópicos protegidos. Enviado como token Bearer

Notificações Gotify

Receba notificações push do seu servidor Gotify auto-hospedado

Configuração do Gotify

O endereço do seu servidor Gotify (http:// funciona na sua LAN)

Crie um aplicativo em Apps no Gotify e copie o token

0 a 10. Aplicativos Gotify geralmente alertam com som a partir de 8

Segurança

Proteja sua instância do SubTrackr com autenticação de login

Exigir Login

Ative a autenticação para proteger seus dados

OpenID Connect

Use um provedor de identidade compatível com descoberta automática, como Pocket ID ou Authentik. Configure a URL Base do aplicativo antes de ativar o OIDC.

Escopos separados por espaço. O escopo openid é sempre incluído.

Registre esta URL de callback no seu provedor: /auth/oidc/callback

Moeda

Escolha sua moeda preferida para exibir os custos das assinaturas

Formato de Data

Escolha como as datas são exibidas em todo o aplicativo

Categorias

Gerencie suas categorias de assinatura

Adicionar Nova Categoria

Chaves de API

Crie chaves de API para acessar o SubTrackr por aplicativos externos

Carregando chaves de API...

Criar Nova Chave de API

API Documentation: Include the API key in the X-API-Key header for all requests. View full API documentation

Sobre o SubTrackr

Versão dev
Build Go + HTMX
Banco de dados SQLite

Documentação da API

Autenticação

Todas as requisições à API requerem autenticação usando uma chave de API. Inclua sua chave de API nos cabeçalhos da requisição:

# Authorization header (recommended)
Authorization: Bearer sk_your_api_key_here
# X-API-Key header (alternative)
X-API-Key: sk_your_api_key_here

Endpoints da API

Assinaturas

Método Endpoint Descrição
GET /api/v1/subscriptions Listar todas as assinaturas
POST /api/v1/subscriptions Criar uma nova assinatura
GET /api/v1/subscriptions/:id Obter detalhes da assinatura
PUT /api/v1/subscriptions/:id Atualizar assinatura
DELETE /api/v1/subscriptions/:id Excluir assinatura

Estatísticas e Exportação

Método Endpoint Descrição
GET /api/v1/stats Obter estatísticas das assinaturas
GET /api/v1/export/csv Exportar assinaturas como CSV
GET /api/v1/export/json Exportar assinaturas como JSON

Assinatura iCal

Método Endpoint Descrição
GET /ical/:token Assinar feed iCal (público, autenticado por token)

Servidor MCP (Integração com IA)

O SubTrackr inclui um servidor Model Context Protocol (MCP) que permite que assistentes de IA como o Claude leiam e gerenciem suas assinaturas por linguagem natural.

Ferramenta Descrição
list_subscriptions Listar todas as assinaturas
get_subscription Obter assinatura por ID
create_subscription Criar uma nova assinatura
update_subscription Atualizar uma assinatura existente
delete_subscription Excluir uma assinatura
get_stats Obter estatísticas das assinaturas
Configuração

Adicione isto à configuração MCP do seu Claude Desktop ou Claude Code:

{
  "mcpServers": {
    "subtrackr": {
      "command": "subtrackr-mcp",
      "args": [],
      "env": {
        "DATABASE_PATH": "/path/to/subtrackr.db"
      }
    }
  }
}

Exemplos de Requisições

Listar Assinaturas

curl -H "Authorization: Bearer sk_your_api_key_here" \
http://localhost:8080/api/v1/subscriptions

Criar Assinatura

curl -X POST \
-H "Authorization: Bearer sk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"name": "Netflix",
"cost": 15.99,
"schedule": "Monthly",
"status": "Active",
"category_id": 1
}' \
http://localhost:8080/api/v1/subscriptions

Obter Estatísticas

curl -H "Authorization: Bearer sk_your_api_key_here" \
http://localhost:8080/api/v1/stats
Resposta:
{
  "total_count": 15,
  "active_count": 12,
  "total_cost": 245.67,
  "categories": {
    "Entertainment": 45.99,
    "Productivity": 89.00,
    "Storage": 29.99
  }
}

Recursos Adicionais

Para documentação mais detalhada da API e exemplos, consulte o arquivo README no repositório do projeto.

The test script test-api.sh provides interactive examples of API usage.