import asyncio from librouteros import connect async def get_interfaces(): loop = asyncio.get_event_loop() api = await loop.run_in_executor(None, connect, '192.168.88.1', 'admin', '') result = await loop.run_in_executor(None, api, '/interface/print') return result
Make sure /ip service set api-ssl disabled=no is enabled on the router. RouterOS 7.14 introduced REST API, but the classic API also works fine. For large networks, try async:
api(cmd='/ip/dhcp-server/lease/add', address='192.168.88.50', mac_address='AA:BB:CC:DD:EE:FF', comment='printer-api') To verify:
If you manage more than one MikroTik router, logging into WinBox or WebFig for every small change gets old fast. The MikroTik API lets you script configuration, gather data, and react to network events — all from your own code.
Try the examples above, then modify them to fit your network. Next week, I’ll cover for live graphing.
leases = api(cmd='/ip/dhcp-server/lease/print') for lease in leases: if lease['comment'] == 'printer-api': print(f"Lease: {lease['address']} -> {lease['mac-address']}") Toggle a rule by comment (safer than index).
api(cmd='/queue/simple/add', name='client-limited', target='192.168.88.100/32', max_limit='5M/5M', comment='api-created') For production, always use SSL on port 8729.
Let me know in the comments. Want the code as a ready-to-use Python script? Download the gist here.
conns = api(cmd='/ip/firewall/connection/print') tcp_count = sum(1 for c in conns if c['protocol'] == 'tcp') udp_count = sum(1 for c in conns if c['protocol'] == 'udp')
print(f"Active connections: TCP={tcp_count}, UDP={udp_count}") Limit a client’s bandwidth via script.
def toggle_rule(comment, enable=True): rule = api(cmd='/ip/firewall/filter/print', .proplist='.id', comment=comment) if rule: cmd = '/ip/firewall/filter/enable' if enable else '/ip/firewall/filter/disable' api(cmd, .id=rule[0]['.id']) print(f"Rule '{comment}' {'enabled' if enable else 'disabled'}") toggle_rule('block-torrent', enable=False) Example 4: Get Active Connections by Protocol Monitor live traffic from Python.