Integrações Apolônia Grade

API e MCP do catálogo público de plantas. A leitura é gratuita, sem cadastro e sem chave administrativa. Não existe um ambiente separado de sandbox: os exemplos GET usam preços e disponibilidade reais da loja e não alteram registros.

Comece pela consulta pública

GET https://apoloniarosadodeserto.com.br/apps/catalogo/v1/products?q=medusa&limit=2
GET https://apoloniarosadodeserto.com.br/apps/catalogo/v1/products/{handle}

Use Accept: application/json para dados ou Accept: text/markdown para texto. A pesquisa aceita q (até 100 caracteres), limit (1 a 20) e after (cursor endCursor da página anterior). Enquanto hasNextPage for true, envie after para continuar.

Contrato e falhas

OpenAPI: https://apoloniarosadodeserto.com.br/apps/catalogo/v1/openapi.json
Política de versão e descontinuação: https://apoloniarosadodeserto.com.br/apps/catalogo/versioning
Permissões: https://apoloniarosadodeserto.com.br/apps/catalogo/access
Preços reais: https://apoloniarosadodeserto.com.br/apps/catalogo/pricing

Erros REST seguem application/problem+json, com type, title, status, detail e resolution. Exemplos seguros: GET /products?limit=99 retorna 400; GET /products/produto-inexistente retorna 404. Respostas 502/503 indicam falha temporária da Shopify, não ausência de estoque. Nunca estime preço quando a origem falhar.

MCP Streamable HTTP

Endpoint: https://apoloniarosadodeserto.com.br/apps/catalogo/mcp
Manifesto: https://apoloniarosadodeserto.com.br/apps/catalogo/server.json

Conecte um cliente MCP por Streamable HTTP. Há duas ferramentas de leitura: search_products e get_product. Há dois recursos consultáveis: este guia e o contrato OpenAPI. O servidor não mantém sessões ou assinaturas; um GET para abrir SSE independente retorna 405, conforme permitido pelo protocolo. POST MCP transporta chamadas de leitura, não ações de compra.

CLI

Código Node.js 20+: https://apoloniarosadodeserto.com.br/apps/catalogo/cli.mjs
Após salvar o arquivo, execute node cli.mjs products medusa ou node cli.mjs product {handle}. O código só faz GET para o catálogo oficial, sem tokens ou gravação de arquivos. A distribuição npm/PyPI não foi publicada.

Limites e decisão do comprador

Nenhum recurso dá acesso a contas, dados pessoais, pedidos, quantidades internas de estoque, descontos administrativos, carrinhos ou pagamentos. Preço, disponibilidade e entrega são confirmados na página oficial e no checkout atual. Descrições de produtos não substituem as políticas comerciais da loja. Nenhuma compra é concluída por esta integração.