dojo.ros: Python and PHP library for the MikroTik RouterOS API

Installation and usage

Installation (Python)

pip install --index-url https://mikrotikdojo.com/en/pypi/<your-address>/simple/ dojo-ros

Usage example (Python)

from dojo.ros import Ros

with Ros("192.0.2.1", "admin", "password") as r:
    print(r.identity())
    res = r.resource()
    print(res["board-name"], "RouterOS", res["version"])

    # query + proplist
    for i in r.cmd("/interface/print", "?running=true", "=.proplist=name,type"):
        print(i["name"], i["type"])

    # scrivere (attento all'interfaccia di gestione!)
    r.cmd("/ip/address/add", address="10.0.0.1/24", interface="bridge1")

# backend REST: stessa interfaccia, basta un flag
with Ros("192.0.2.1", "admin", "password", rest=True) as r:
    print(r.identity())

Installation (PHP)

composer config repositories.dojo composer https://mikrotikdojo.com/en/composer/<your-address>/
composer require dojo/ros

Usage example (PHP)

use Dojo\Ros\Ros;

$r = new Ros("192.0.2.1", "admin", "password");   // API binaria, 8728
$r->connect();
echo $r->identity(), "\n";
$res = $r->resource();
echo $res["board-name"], " RouterOS ", $res["version"], "\n";

foreach ($r->cmd("/interface/print", ["?running=true", "=.proplist=name,type"]) as $i) {
    echo $i["name"], " ", $i["type"], "\n";
}
$r->close();

// backend REST: stessa interfaccia
$r = new Ros("192.0.2.1", "admin", "password", null, false, 10, true);