Conectores
ERP
Magis5
6 min
objetivo o conector magis5 integra a plataforma fluid à api pública do magis5 , permitindo consultar e enviar pedidos, produtos, notas fiscais, etiquetas, anúncios e canais de venda é direcionado a clientes e equipes de suporte , oferecendo sincronização completa de dados de e commerce entre o magis5 e sistemas conectados via fluid documentação oficial da api https //developers magis5 com br/docs/magis5 public/802bo3bosw7wq como consigo um token para integrar a api magis5 https //app magis5 com br/v1/ui/index html requisitos (criando conexão true 165,165,165,166left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type autenticação a autenticação é feita exclusivamente via chave de api , passada no header x magis5 apikey {sua chave magis5} observações de segurança o campo é marcado como fld secret true e não é exibido em logs ou interfaces públicas a chave é gerada e controlada pelo próprio magis5 recomenda se armazenar o valor em variáveis seguras (vault) e revisar periodicamente sua validade configurando um fluxo formato application/json paginação via \ limit e \ page filtros parâmetros como \ status, \ timestampfrom, \ timestampto, \ structuretype, \ enablelink autenticação header x magis5 apikey validação todos os campos obrigatórios devem seguir o schema ambientes definidos pela própria chave de api (sandbox ou produção) recursos e operações principais recursos suportados true 220,220,221left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type na prática boas práticas sempre incluir o header x magis5 apikey validar a chave antes da execução testar primeiro com chamadas de leitura (get) disparando o fluxo modos de execução manual, evento externo ou agendamento validação sucesso indicado por http 200 ou 201; falhas retornam http 4xx/5xx testes recomendados get /health para validar comunicação get /orders?limit=1 para confirmar acesso autenticado conclusão o conector magis5 permite integração completa com os recursos principais da api magis5 (pedidos, produtos, notas fiscais, anúncios e canais) o modelo de autenticação via api key simplifica a configuração e garante segurança, sem necessidade de autenticação via login