Como Configurar JSON API no Mikrotik: Passo a Passo

· Atualizado em
A JSON API no Mikrotik é uma interface que permite a comunicação com o roteador usando o formato JSON. Ela é amplamente utilizada para integrar o Mikrotik a sistemas externos, como ferramentas de monitoramento ou automação, proporcionando uma maneira eficiente de gerenciar e monitorar o dispositivo remotamente.

Passo a Passo para Configurar JSON API no Mikrotik

1. Acesse o Mikrotik

  • Conecte-se ao roteador via WinBox, SSH, ou interface Web.

2. Habilite o Serviço API

  • Certifique-se de que o serviço API está ativo no roteador. Use o comando: 
    /ip service enable api
  • Por padrão, o serviço API utiliza a porta 8728. Para habilitar a versão segura (SSL): 
    /ip service enable api-ssl

3. Ajuste a Porta do Serviço API (opcional)

  • Caso queira alterar a porta padrão para evitar conflitos ou melhorar a segurança: 
    /ip service set api port=8080

4. Configure o Firewall para o Serviço API

  • Garanta que o acesso ao serviço API seja permitido apenas para IPs confiáveis: 
    /ip firewall filter add chain=input protocol=tcp dst-port=8728 src-address=192.168.1.0/24 action=accept comment="Permitir acesso API"
/ip firewall filter add chain=input protocol=tcp dst-port=8728 action=drop comment="Bloquear outros acessos API"

5. Teste o Acesso à API

  • Use uma ferramenta de requisições, como Postman ou cURL, para enviar comandos ao Mikrotik.
  • Exemplo de comando cURL: 
    curl -u admin:senha -X POST <a target="_new" rel="noopener">http://192.168.1.1:8728/jsonrpc</a> -d '{"id":1, "method":"/ip/address/print"}'

6. Integre o Mikrotik com Sistemas Externos

  • Utilize bibliotecas compatíveis com JSON API, como RouterOS API for PHP ou scripts personalizados em Python: 
    import requests
url = "<a target="_new" rel="noopener">http://192.168.1.1:8728/jsonrpc</a>"
payload = {"id": 1, "method": "/ip/address/print"}
response = requests.post(url, json=payload, auth=('admin', 'senha'))
print(response.json())

7. Habilite Logs para Monitorar o Serviço API (opcional)

  • Ative logs específicos para acompanhar o uso da API: 
    /system logging add topics=api action=memory

Considerações Finais

A JSON API no Mikrotik é uma solução poderosa para gerenciar e monitorar o roteador de maneira automatizada. Configurá-la corretamente garante integração segura com sistemas externos, otimizando o gerenciamento da sua rede.