Como Integrar com as APIs do Grupo Magalu
Esta seção contém toda a documentação necessária para integrar sua aplicação com as APIs do grupo Magalu, desde a configuração inicial até a realização de chamadas autenticadas.
Visão Geral do Processo
Para utilizar as APIs do grupo Magalu, você precisa seguir um fluxo de autenticação OAuth 2.0 que envolve quatro etapas principais:
Passo a Passo Completo
Criar e Configurar um Cliente de Aplicação
O que você fará: Configurar sua aplicação no sistema do ID Magalu para obter credenciais de acesso.
Principais tópicos:
- Instalação e configuração do IDM (ID Magalu CLI)
- Criação do client com escopos necessários
- Configuração de URLs de redirecionamento
- Gerenciamento seguro das credenciais
Resultado: Você terá um client_id
e client_secret
para sua aplicação.
Obter Autorização do Seller via OAuth 2.0
O que você fará: Implementar o fluxo OAuth 2.0 para obter consentimento dos sellers e gerar tokens de acesso.
Principais tópicos:
- Solicitação de consentimento do seller (botão ou URL)
- Processamento do código de autorização
- Troca do código por tokens de acesso
- Renovação automática de tokens
Resultado: Você terá access_tokens
válidos para fazer chamadas às APIs.
Explorar e consumir as APIs disponíveis
O que você fará: Conhecer e integrar as diferentes APIs do ecossistema Magalu para construir suas soluções.
Principais tópicos:
- Identificação das APIs adequadas para seu caso de uso
- Estrutura das requisições e respostas
- Tratamento de erros e boas práticas
- Exemplos práticos de integração
APIs Disponíveis:
- Produtos: Gerenciamento de produtos, preços e estoque do seu catálogo
- Pedidos: Processamento e acompanhamento de pedidos
- SAC (Customer Service): Atendimento ao cliente e gerenciamento de tickets
- Perguntas & Respostas: Sistema de perguntas e respostas de produtos
- Chat com o cliente: Gerenciamento de conversas com clientes
- Webhooks: Configuração de notificações em tempo real
- Traces: Rastreamento e monitoramento de requisições
Resultado: Você terá integrado as APIs necessárias para seu caso de uso específico.