Versões

⚠️ Guia de Transição: API Oficial Única e Novo Acesso de Segurança

Bem-vindo ao Portal do Desenvolvedor do Aiqfome.

Com o objetivo de simplificar e fortalecer nossa plataforma, o aiqfome está consolidando todas as integrações na API V2 e descontinuando a API V1. A API V2 é a nossa solução definitiva e unificada, capaz de gerenciar lojas tanto do tipo Catálogo quanto Cardápio.

A principal mudança técnica é a implementação do ID Magalu como novo padrão de autenticação. Diferente do modelo anterior, a autorização agora passa a ser por loja, garantindo maior segurança e controle individual para cada unidade do portfólio do seller.

A partir de 05/01/2026, a API V2 passará a ser a única API oficial, incorporando o sistema de Autenticação via ID Magalu.

Recomendamos que novos parceiros aguardem o lançamento oficial em 05/01/2026 para iniciar o desenvolvimento, evitando o retrabalho de migração da API V1

1. O Novo Padrão de Integração: API V2 e ID Magalu

A API V2 agora se torna a plataforma unificada, suportando lojas do tipo Lojas do tipo Catálogo (Mercados, Pets, Farmácias) e Lojas do tipo Cardápio (Restaurantes). O principal impacto é a mudança no modelo de segurança.

Alerta Crítico: Novo Modelo de Autorização (Por Loja)

Este é o ponto mais importante desta comunicação e exige sua atenção:

Antes (API aiqfome V1)	Agora (API V2 com ID Magalu)
Autorização por Usuário: O usuário dono da loja autorizava o parceiro no Geraldo, e todas as lojas desse usuário eram liberadas com um único token.	Autorização por Loja: O usuário dono da loja deve autorizar individualmente cada loja de seu portfólio para o parceiro integrador.
Resultado: Um único Access Token gerenciava todas as lojas.	Resultado: Cada loja autorizada terá seu próprio e exclusivo Access Token. Seu sistema precisará gerenciar e utilizar o token correto para a loja que deseja gerenciar.

2. Cenário para Parceiros Atualmente Integrados com a API V0 (Alfredo)

Se sua empresa já utiliza a API aiqfome V0 (Alfredo), a boa notícia é que não há impacto em seu código de integração (Endpoints e Payloads).

Ação Necessária do Parceiro (Recomendado)

Devido à migração para o novo modelo de autenticação (ID Magalu e autorização por loja), você deverá seguir os passos de cadastro e nova autorização a partir de 05/01/2026:

1. Portal do Desenvolvedor: Crie sua conta e registre sua Aplicação de Produção.
2. Avisar o Seller: O Seller precisará autorizar a sua aplicação, loja por loja, através do menu de Integrações do painel do Geraldo.
3. Obtenção de Novos Tokens: Seu sistema deve implementar o fluxo para obter o Access Token específico para cada Loja autorizada, utilizando o novo padrão ID Magalu.

Para mais detalhes sobre cada etapa deste processo, consulte o passo a passo completo em nossa documentação oficial: Credenciais e Autenticação

3. Cenário para Parceiros Atualmente Integrados com a API V1

A API V1 será descontinuada em 07/04/2026, 90 dias a partir do lançamento da nova versão. A migração para a API V2 é obrigatória.

Ação Necessária (Obrigatório)

Status da Loja	Ação do Parceiro
Lojas Existentes (Já Autorizadas na V1):	Continuarão ativas na API V1 por um período de transição até 07/04/2026.
Novas Lojas (Qualquer Loja após 05/01/2026)	Você deverá migrar para a API V2. A autorização de novas lojas só será possível via API V2 a partir de 05/01/2026.

Se você integra com a API V1, prepare-se para:

1. Desenvolvimento: Necessário integrar-se aos endpoints da API V2.
2. Autenticação: Adotar o novo modelo de Autorização por Loja via ID Magalu.

Próximos Passos e Suporte

O processo básico de credenciamento, criação de conta e obtenção de client_id e client_secret permanece o mesmo e deve ser consultado em nossa documentação oficial:

Credenciais e Autenticação