Versões e descontinuação

Como a Siglata numera as interfaces para agentes, o que conta como mudança incompatível e quanto aviso você recebe antes de uma remoção.

Nada está descontinuado hoje. Esta página diz como a Siglata avisa quando isso mudar.

Onde está a versão

Endpoint MCP: a versão está na URL, https://www.siglata.com/v1/mcp.
Servidor MCP: serverInfo.version no initialize e o cartão do servidor trazem a versão do servidor, em MAJOR.MINOR.PATCH.
Busca pública: a descrição OpenAPI traz a versão em info.version.

O que é incompatível

Aumentamos a versão da URL e o MAJOR do servidor quando:

uma operação do MCP muda de nome ou é removida;
um parâmetro obrigatório é acrescentado, ou um parâmetro ou resultado muda de tipo ou de significado;
um escopo OAuth deixa de dar o acesso que dava.

Não são incompatíveis: uma operação nova, um parâmetro opcional novo, um campo novo no resultado ou uma mensagem de erro com texto melhor. Ignore campos que você não conhece.

Aviso antes de remover

A mudança é anunciada nesta documentação e a versão antiga continua funcionando ao lado da nova.
Cada resposta da versão antiga passa a levar o cabeçalho Deprecation (RFC 9745) e o cabeçalho Sunset (RFC 8594) com a data de remoção.
A remoção acontece no mínimo 90 dias depois do anúncio.

Limites de uso

Quando um limite de taxa recusa uma chamada, a resposta é 429 com o cabeçalho Retry-After, em segundos. Hoje isso vale para as rotas de autenticação em https://www.siglata.com/auth.