API e Desenvolvedores

API pública, somente leitura, pensada para integrações e agentes de IA.

Início rápido

Nenhuma chave de API é necessária: os endpoints públicos são abertos, somente leitura e aceitam CORS de qualquer origem. Para operações de conta (assinaturas, usuários, créditos), use a área logada em /login ou fale conosco.

curl -s https://www.vision-cast.io/api/public/products

Especificação OpenAPI 3.1

/openapi.json — especificação em JSON
/api/public/openapi.yaml — mesma especificação em YAML
/api — índice de endpoints em JSON

Endpoints

GET/api/public/health
Verificação de disponibilidade do serviço.
GET/api/public/products
Catálogo dos sete módulos do ecossistema, com nome, descrição e público-alvo.
GET/api/public/pricing?modules=3
Tabela de preços mensal em BRL. O parâmetro modules (1 a 7) é opcional.

Sandbox

Os endpoints públicos são idempotentes e não alteram dados — pode chamá-los à vontade em desenvolvimento, sem ambiente separado. Limite recomendado: 60 requisições por minuto.

Formato de erros

Erros seguem application/problem+json com código, mensagem, dica de resolução e status.

{
  "error": {
    "code": "invalid_parameter",
    "message": "O parâmetro modules deve ser um inteiro entre 1 e 7.",
    "hint": "Use ?modules=3 ou remova o parâmetro.",
    "status": 400,
    "docs": "https://www.vision-cast.io/openapi.json"
  }
}

Conteúdo em markdown

As páginas canônicas respondem em markdown quando a requisição envia Accept: text/markdown. Toda resposta negociada leva Vary: Accept, Accept-Encoding.

curl -s -H "Accept: text/markdown" https://www.vision-cast.io/preco

Para agentes de IA

O índice /llms.txt descreve quando usar o Vision Cast, quais páginas consultar e como chamar a API.

Suporte

Dúvidas de integração: contato@vision-cast.io.