API da Doce Cesta

Início rápido

Não precisa de chave nem cadastro. Teste agora:

curl "https://docecesta.com.br/api/public/v1/products?q=rosas&limit=5"

A API serve para descobrir a loja e comparar produtos. Ela não cria carrinho, pedido nem pagamento: a compra acontece no site ou no atendimento da loja, sempre com a confirmação da pessoa.

Endereços

• GET /api/public/v1: índice da API
• GET /api/public/v1/store: dados públicos da loja
• GET /api/public/v1/products: produtos (q, category, limit, offset)
• GET /api/public/v1/products/{slug}: um produto pelo fim da URL /produtos/{slug}

Contrato completo em OpenAPI 3.1. Lista de preços em pricing.md. Resumo da loja em llms.txt e instruções em agents.md.

Servidor MCP

Endereço https://docecesta.com.br/mcp, por Streamable HTTP e JSON-RPC 2.0 (protocolo 2025-06-18). Ferramentas, todas somente leitura:

• get_store: Identidade oficial, área atendida, canais de contato e URLs de recurso desta loja. Use quando a pessoa perguntar quem é a loja, onde entrega ou como falar com ela.
• list_products: Busca e pagina os produtos publicados. Use para descobrir e comparar presentes; confirme as condições finais na loja.
• get_product: Um produto publicado pelo slug canônico (o fim da URL /produtos/{slug}).

Erros

Todo erro responde em application/problem+json, com status, code, detail e hint, que diz o que fazer.

Limite de chamadas

Até 120 chamadas por minuto por IP. As respostas trazem os cabeçalhos RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Passou do limite, a resposta é 429 com Retry-After. Respostas podem vir de cache por alguns minutos.

Versões

A versão fica no caminho (/v1). Campo novo pode entrar sem mudar a versão. Mudança incompatível vira uma versão nova, e a anterior avisa com os cabeçalhos Deprecation e Sunset antes de sair. O caminho sem versão, /api/public, responde igual à v1.

Preço e disponibilidade

São um retrato do momento. Confirme na página do produto antes de responder, e não conclua compra nem prometa condição comercial sem a confirmação da pessoa.