Pular para o conteúdo principal

Changelog

Registro de todas as alteracoes na API Externa Tesselys. Seguimos Semantic Versioning para controle de versoes.

v1.0.0 (2026-03)​

Lancamento inicial da API Externa Tesselys.

Recursos​

  • Autenticacao: API Key + Secret com emissao de JWT tokens

    • POST /external/v1/auth — autenticacao
    • POST /external/v1/auth/refresh-token — renovacao de token

  • Pessoas (Persons): CRUD completo

    • GET /external/v1/persons — listar com paginacao e filtros
    • GET /external/v1/persons/:id — buscar por ID
    • POST /external/v1/persons — criar
    • PUT /external/v1/persons/:id — atualizar

  • Negocios (Deals): CRUD completo

    • GET /external/v1/deals — listar com paginacao e filtros
    • GET /external/v1/deals/:id — buscar por ID
    • POST /external/v1/deals — criar
    • PUT /external/v1/deals/:id — atualizar

  • Lancamentos Financeiros (Financial Entries): leitura e criacao

    • GET /external/v1/financial-entries — listar com paginacao e filtros
    • GET /external/v1/financial-entries/:id — buscar por ID
    • POST /external/v1/financial-entries — criar (avista e parcelado)

  • Produtos (Products): CRUD completo

    • GET /external/v1/products — listar com paginacao e filtros
    • GET /external/v1/products/:id — buscar por ID
    • POST /external/v1/products — criar
    • PUT /external/v1/products/:id — atualizar

  • Projetos (Projects): leitura e criacao

    • GET /external/v1/projects — listar com paginacao e filtros
    • GET /external/v1/projects/:id — buscar por ID
    • POST /external/v1/projects — criar

Webhooks​

  • Configuracao de assinaturas via API e painel administrativo
  • Eventos disponiveis: person.*, deal.*, financial.*, product.*, project.*
  • Validacao de assinatura HMAC-SHA256
  • Politica de retry com ate 5 tentativas

Infraestrutura​

  • Rate limit: 100 requisicoes por minuto por empresa
  • Formato padronizado de erros com friendlyMessage em portugues
  • Suporte a paginacao em todos os endpoints de listagem

Formato para Entradas Futuras​

## vX.Y.Z (AAAA-MM)

### Adicionado
- Descricao do novo recurso ou endpoint

### Alterado
- Descricao da alteracao em recurso existente

### Corrigido
- Descricao do bug corrigido

### Depreciado
- Descricao do recurso marcado para remocao futura

### Removido
- Descricao do recurso removido
Notificacoes

Para ser notificado sobre novas versoes da API, acesse Configuracoes → Integracoes → API Externa no painel administrativo e ative as notificacoes de changelog.

Última atualização em