Data Talks
    Documentação

    Referência da API

    Cada endpoint, cada webhook, cada chamada de ferramenta. A referência completa da API REST do Data Talks.

    Começar agoraGitHub README
    Autenticação

    Duas formas de autenticar

    JWT Bearer Token

    Use email/senha para obter um token JWT via /auth/login. Passe como Bearer token no header Authorization para todas as requisições subsequentes.

    API Key (X-API-Key)

    Gere chaves de API (prefixo dtk_) por agente. Passe via header X-API-Key. Ideal para acesso programático e integrações.

    Autenticação

    POST/auth/register
    POST/auth/login
    GET/auth/me

    Agentes

    GET/agents
    POST/agents
    PATCH/agents/{id}
    DELETE/agents/{id}
    GET/agents/{id}/sources

    API de Perguntas

    POST/ask
    POST/v1/ask

    Fontes de Dados

    GET/sources
    POST/sources
    POST/sources/upload
    DELETE/sources/{id}
    GET/sources/{id}/preview

    Relatórios

    GET/reports
    POST/reports
    POST/reports/{id}/run

    Webhooks

    GET/webhooks
    POST/webhooks
    DELETE/webhooks/{id}

    Alertas

    GET/alerts
    POST/alerts
    POST/alerts/{id}/test
    GET/alerts/{id}/history

    Chaves de API

    GET/api-keys
    POST/api-keys
    DELETE/api-keys/{id}

    Configuração de LLM

    GET/llm/configs
    POST/llm/configs
    GET/llm/health
    Webhooks

    Eventos de webhook outgoing

    Configure webhooks outgoing por agente. Cada evento é assinado com HMAC-SHA256 para verificação. Headers customizados suportados.

    Eventos suportados

    alert.executedreport.generated

    Verificação de assinatura

    HMAC-SHA256(secret, payload_body) → X-Webhook-Signature