Visão geral

API do WhizBuddy

REST sobre HTTPS. JSON em ambas as direções. Autenticação via JWT Bearer (HS256, expiração 15min) com refresh token rotativo. Todas as rotas vivem sob /v1.

BASE URL
https://api.whizbuddy.cloud/v1

Princípios

  • Versionada — toda rota tem prefixo /v1. Breaking changes ganham /v2.
  • Assíncrona — jobs e tarefas devolvem 202 e se acompanham por polling (não há SSE/webhook de progresso).
  • Erros consistentes — RFC 7807 (application/problem+json): { type, title, status, code, detail }.
  • Rate-limited — autenticação interativa: 10 tentativas/15min por IP e também por email no login; refresh tem cota própria por família de sessão. Criação de job e chamadas LLM consomem cota diária por usuário.
  • Observável — métricas Prometheus em /v1/metrics (Bearer opcional via METRICS_TOKEN).