Compatibilidade Universal (Lojas IA e Ferramentas de Recuperação)
A infraestrutura da API da Zedy foi projetada de forma agnóstica, o que significa que ela não depende de uma plataforma específica para funcionar. Ela serve perfeitamente para:
Sistemas e Lojas Criadas por IA: Conectividade total e simplificada para aplicações estruturadas via Lovable, Cursor, v0, Bolt.new ou qualquer outro construtor baseado em prompts de inteligência artificial.
Ferramentas de Recuperação Externas: Pronta para integrar com sistemas próprios ou terceirizados de recuperação de carrinho, automações de disparo de mensagens (WhatsApp/SMS) e CRMs que necessitam consultar dados de produtos ou injetar checkouts dinâmicos.
Agentes Autônomos (LLMs): Estrutura de endpoints padronizada para que agentes de IA leiam o catálogo em formato JSON e gerem links de pagamento em tempo real durante interações com o cliente final.
A API da Zedy foi desenvolvida com foco em integração ágil. Ela permite que inteligências artificiais e desenvolvedores consigam interagir diretamente com a plataforma para:
Listar o catálogo completo de produtos e coleções.
Buscar detalhes específicos de itens e recomendações.
Criar checkouts transparentes de alta conversão de forma automatizada.
Dados de Conexão Base
Para iniciar qualquer desenvolvimento ou instruir o seu construtor de IA, utilize a URL base oficial da API:
Como instruir a IA (Lovable ou Cursor)
Se você estiver utilizando uma ferramenta de criação por IA para gerar sua loja ou aplicativo, forneça as seguintes diretrizes iniciais no prompt:
Forneça a documentação: Informe a URL completa de referência (
[https://app.zedy.com.br/docs](https://app.zedy.com.br/docs)) para que a IA entenda a estrutura dos endpoints.Defina as rotas principais: Explique que o sistema funciona consumindo rotas de consulta (como
/productse/collections) e uma rota de ação principal para vendas (/checkout).Autenticação: Oriente a IA a isolar as chaves de API em variáveis de ambiente seguras dentro do projeto Lovable/Cursor.
Endpoints Disponíveis para Desenvolvimento
Abaixo estão os recursos que sua aplicação poderá consumir utilizando o método GET para consultas e POST para ações:
Produtos: Listar produtos (
/products), detalhes por slug (/products/{slug}) e produtos recomendados.Coleções: Listar coleções (
/collections) e detalhes da coleção por handle.Loja e Busca: Listar dados gerais da loja (
/store) e buscar produtos por termo (/search).Checkout: Criar a sessão de finalização de compra (
/checkout) enviando os dados do carrinho.
Próximos Passos
Para dar andamento à integração no seu ambiente Lovable:
Acesse o artigo Autenticação e Chaves de API para aprender a gerar suas credenciais de acesso.
Consulte o artigo Modelos de Payload (POST Criar checkout) para entender a estrutura de dados exata que sua aplicação deve enviar para processar as vendas.