API NOVA (3.0)
? O que é uma API?
API significa Application Programming Interface, ou Interface de Programação de Aplicações.
De forma objetiva, é um conjunto de padrões que permite que dois sistemas diferentes se comuniquem diretamente, de forma automática, segura e organizada.
Na prática, a API permite que desenvolvedores criem integrações com o sistema da CPlug para consultar, cadastrar, atualizar ou excluir dados, como clientes, produtos, vendas, entre outros.
? O que muda na Nova API da CPlug?
A nova API da CPlug foi desenvolvida para atender demandas mais complexas e proporcionar maior controle e segurança nas integrações. Ela não substitui imediatamente a API anterior — ambas seguem ativas, mas com objetivos distintos.
Principais mudanças:
? Controle por integrador:
Agora, é necessário cadastrar o desenvolvedor como um integrador, com informações como nome, CNPJ, e-mail de desenvolvimento e telefone. Cada integrador recebe credenciais fixas e exclusivas (Client ID e Client Secret).
? Gerenciamento de múltiplas lojas:
Após o cadastro do integrador, as lojas são vinculadas a ele com base no schema e no e-mail do usuário principal da loja, o que permite centralizar o acesso em uma única conta (útil para quem integra várias lojas com um mesmo sistema).
? Autenticação mais robusta:
A autenticação é feita via Client ID + Secret + usuário e senha da loja, garantindo maior segurança e rastreabilidade.
? Envio de credenciais:
As credenciais são enviadas diretamente por e-mail aos desenvolvedor pelo responsável técnico Cplug.
O e-mail do desenvolvedor é essencial para o recebimento de logs e notificações de atualizações da API.
⚙️ Funcionalidades da Nova API
A nova API possui todas as funcionalidades da versão anterior e novas funções em constante expansão.
? Importante:
Como a nova API está em evolução contínua, é fundamental que o desenvolvedor consulte regularmente a documentação oficial para acompanhar os recursos disponíveis:
? Documentação oficial da nova API – Redocly
Além disso, os desenvolvedores cadastrados recebem por e-mail notificações automáticas com logs de mudança e atualizações da API, garantindo que estejam sempre atualizados com as novidades.
? Como liberar o uso da nova API?
Para liberar o uso da nova API, se faz necessário:
Abrir um chamado no Movidesk destinado ao N2
Utilizar a macro específica para nova API:
Preencher todas as informações obrigatórias:
Nome e CNPJ do integrador
E-mail de desenvolvimento
Telefone
Schema(s) da(s) loja(s) a serem vinculadas
E-mail do usuário principal da loja
? Importante: o processo é manual e controlado pela equipe técnica para garantir segurança.
? Valor
A liberação da API (tanto nova quanto antiga) tem um custo único de R$ 299,00/mês.