StudioW Data API

O que há de novo

07/07

raw_data completo em GET /v1/lancamentos

A listagem agora retorna o JSON completo de cada lançamento (Pessoa, CentroCusto, ValorBruto, DataVencimento etc.) — antes isso só vinha em GET /v1/lancamentos/:id.

07/07

Paginação por cursor (after_id) em GET /v1/lancamentos

Pensada pra sincronizar/importar a tabela inteira sem o custo de COUNT(*)/OFFSET — use after_id em vez de page. Detalhes na documentação.

Histórico completo em CHANGELOG.md.

Por que usar com agentes de IA

Dados reais, sem alucinação

O agente consulta dados reais do DW em vez de inventar valores. Transações, profissionais e relatórios vêm direto do banco.

OpenAPI 3.1 nativo

Qualquer ferramenta que leia OpenAPI (Cursor, VS Code, GPT, Claude) entende automaticamente todos os endpoints, parâmetros e schemas.

JWT com refresh token

Autenticação segura com access token de curta duração. O agente renova automaticamente quando expirar — sem re-login manual.

Relatórios prontos

Endpoints de relatório já agregam dados por profissional e forma de pagamento — o agente não precisa processar dados brutos.

Fluxo de autenticação

Login — obter tokens

POST /auth/login com email e senha → recebe access_token (15 min) + refresh_token (7 dias)

Usar o access_token

Todas as requisições precisam do header Authorization: Bearer <access_token>

Renovar quando expirar (HTTP 401)

POST /auth/refresh com o refresh_token → novo par de tokens. O anterior é revogado.

CURL — Login

curl -X POST https://api.studiow.com.br/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"seu@email.com","password":"sua_senha"}'

Endpoints disponíveis

GET

/v1/transacoes

Transações do salão — filtros: data_inicio, data_fim, estabelecimento_id, sent_to_kamino

GET

/v1/transacoes/:id

Transação individual com raw_data completo da API Trinx

GET

/v1/lancamentos

Lançamentos enviados ao Trinx via Kamino

GET

/v1/lancamentos/:id

Lançamento individual com raw_data completo

GET

/v1/pagamentos-kamino

Todos os pagamentos do Kamino (pagos e pendentes, qualquer categoria/centro de custo) — independente da integração Trinx

GET

/v1/pagamentos-kamino/:id

Pagamento individual por kamino_id, com raw_data completo

GET

/v1/profissionais

Mapeamento de profissionais Trinx ↔ Kamino

GET

/v1/estabelecimentos

Mapeamento de estabelecimentos Trinx ↔ Kamino

GET

/v1/jobs-log

Histórico de execução dos workers de sincronização

GET

/v1/relatorios/resumo

Métricas consolidadas: totais, valores, status dos jobs

GET

/v1/relatorios/transacoes-por-profissional

Volume e valor agrupados por profissional

GET

/v1/relatorios/transacoes-por-forma-pagamento

Volume, valor, ticket médio e taxas por forma de pagamento

Como conectar agentes de IA

Claude (claude.ai / Claude Desktop)

Carregue as instruções direto no prompt do agente:

PROMPT

Leia as instruções em https://api.studiow.com.br/llms.txt e use a API
para responder minha pergunta sobre os dados do StudioW.

Cursor / VS Code / qualquer cliente OpenAPI

Aponte para a spec OpenAPI — o cliente descobre todos os endpoints automaticamente:

Cursor — mcp.json

{
  "openapi": {
    "url": "https://api.studiow.com.br/openapi.yaml"
  }
}

VS Code — settings.json

{
  "openapi.specFiles": [
    "https://api.studiow.com.br/openapi.yaml"
  ]
}

n8n / Make / Zapier

Use o nó HTTP com autenticação Bearer Token:

Configuração

Base URL:   https://api.studiow.com.br
Auth Type:  Bearer Token
Token:      <access_token via POST /auth/login>
OpenAPI:    https://api.studiow.com.br/openapi.yaml