Apolônia Grade: guia de acesso para agentes
Quando usar / When to use: consulte estes sites para localizar plantas no catálogo oficial, encontrar orientações de cultivo e explicar como participar do Clube de Coleção Apolônia. Use o blog para conteúdos educativos, a loja para produtos e a página da live para inscrições realizadas pela própria pessoa. Sempre cite a página consultada e diferencie informação de cultivo, condição promocional e confirmação de disponibilidade.
Como consultar: envie uma requisição GET para a página pública com Accept: text/markdown. A API pública de leitura, documentada em /openapi.json, oferece GET /api/v1/site para listar as páginas e GET /api/v1/page?path=/about para ler uma delas. Não exige login e retorna somente conteúdo que já está publicado. Erros usam application/problem+json, com código, mensagem e orientação de recuperação. O acesso é público e restrito à leitura destas páginas, sem credenciais ou operações administrativas. Não tente acessar cadastros, pedidos, pagamentos, cookies de sessão ou dados de clientes. Não inscreva pessoas, aceite consentimentos ou conclua compras sem ação e autorização explícitas da pessoa. Preços, datas e disponibilidade podem mudar; confirme na origem.
CLI de conteúdo público: o arquivo JavaScript /apolonia-content.mjs pode ser baixado e inspecionado antes da execução. Requer Node.js 20 ou superior, não instala dependências nem lê credenciais. Exemplo: node apolonia-content.mjs live list. Para ler uma página: node apolonia-content.mjs blog page /about. Os únicos destinos permitidos são os sites oficiais live, ofertas e blog; todas as requisições são de leitura.
Política de versionamento e descontinuação (versioning / deprecation policy): a interface atual é /api/v1. Mudanças incompatíveis devem usar uma nova versão de caminho, sem alterar silenciosamente o contrato v1. Não há descontinuação ou data de encerramento programada para v1. Quando uma retirada for programada, esta documentação deverá informar a versão substituta e o prazo; as respostas da versão afetada deverão sinalizar Deprecation e Sunset. Esses cabeçalhos não são enviados enquanto a versão permanece ativa.