CORE - Geral

APIs do núcleo da Plataforma Keeptor — autenticação, banco de dados, dicionário, preferências de usuário e gerenciamento de sessões.

CORE — Geral

APIs do núcleo da Plataforma Keeptor. Cobrem:

  • Autenticação — login, renovação de token, logout e troca de organização
  • Banco de dados (CRUD) — endpoint único para consultas e gravações + endpoint para metadados de entidades (/dictionary)
  • Preferências do usuário — configurações persistentes (colunas de tabelas, layouts)

Todas as rotas (exceto /login e /refresh) exigem Authorization: Bearer <access_token>. Cada chamada é validada e a Plataforma garante que o usuário só acesse dados da sua própria organização.

Convenções gerais

  • Base URL produção: https://api.keeptor.com/prd/v1
  • Base URL homologação: https://api.keeptor.com/tst/v1
  • Schema de resposta: padrão Keeptor — { success, data, message?, error? }
  • Schema de erro: ErrorResponse com error.type em UPPER_SNAKE_CASE (lista canônica no schema do OpenAPI)
  • Idioma: mensagens user-facing sempre em PT-BR
  • Content-Type: application/json