Ir para o conteúdo
Waseit

Desenvolvedores

API e MCP

Uma chave, duas portas: a API REST v1 para suas ferramentas, o servidor MCP para seus assistentes de IA. Os dois leem as mesmas medições do seu portal - refeitas a cada 3 dias - e não disparam nada: somente leitura é uma escolha, não uma falta.

Sua chave

A chave é gerada no seu portal de gestão (seção « API e MCP »). Ela aparece uma única vez, uma chave ativa por conta - gerar uma nova revoga a antiga. Envie no cabeçalho:

curl https://waseit.net/api/v1/brands \
  -H "Authorization: Bearer wa_live_VOTRE_CLE"

A API v1, somente leitura

  • GET /api/v1/mea conta por trás da chave: plano, idioma, número de marcas
  • GET /api/v1/brandssuas marcas monitoradas, com mercado, setor, concorrentes e datas de medição
  • GET /api/v1/brands/:id/snapshots?limit=24o histórico datado de uma marca, do mais recente ao mais antigo, com a URL do relatório público por ponto
  • GET /api/v1/brands/:id/latesta última medição e seu delta frente à anterior (null enquanto houver um único ponto)

Descrição completa para máquinas: openapi.json

O servidor MCP

A mesma conta, falada por um assistente: ChatGPT, Claude ou qualquer cliente MCP pode listar suas marcas, ler a última medição e o histórico. Transporte « Streamable HTTP », autenticação pela mesma chave. Adicione este conector:

{
  "mcpServers": {
    "waseit": {
      "url": "https://waseit.net/api/mcp",
      "headers": { "Authorization": "Bearer wa_live_VOTRE_CLE" }
    }
  }
}

Ferramentas expostas: list_brands, get_latest_measurement(brand), get_score_history(brand, limit). As marcas são endereçadas pelo nome.

O que a API não vai fazer

  • Disparar uma medição: as medições chegam pela cadência de 3 dias, a API as lê. Uma API de escrita seria uma superfície de abuso antes de ser um serviço.
  • Dar um número que o portal não tem: a API expõe os snapshots que o produto fabrica, nunca um cálculo paralelo que possa divergir.
  • Prometer uma posição: cada resposta é uma medição datada - essa é toda a tese.

A chave está incluída em todos os planos