admin管理员组

文章数量:1531315

2024年6月25日发(作者：)

ROS API 中文说明

前言：

ROS 是 一个比较流行的软路由系统，它的强大在于它的高度定制性，它提供了应用程

序编程使用的API接口，是它应用更加灵活，我们可以自己开发软件或WEB程序来操控

ROS，比较实用的例子就是当用ROS管理小区网络时，我们用自己写的软件来管理上网账

号，安全又方便，总之好处多多，

本文基于官方API文档：/wiki/API 翻译而成，结合了作者的理解，

水平有限，难免有错漏的地方，望大家批评指正，谢谢！

正文：

目录

1 简介

2 通讯协议

2.1 API词

2.1.1 命令词

2.1.2 属性词

2.1.3 API 属性词

2.1.4 查询语句

2.1.5 回复语句

2.2 API 特定命令说明

3 初始登录

4 标签(.Tags )

5 API命令说明

5.1 查询词说明

5.2 OID

6 API 命令例子

6.1 /system/package/getall

6.2 /user/active/listen

6.3 /cancel, simultaneous commands

7 客户端程序例子

8 参考

8.1 API examples in the Wiki

8.2 API examples on the MikroTik Forum

8.3 API exmaples elsewhere

简介：

应用程序编程接口（API），允许用户创建定制的软件解决方案与RouterOS的

沟通，收集信息，调整配置和管理路由器。 API紧随命令行界面（CLI）的语法。

它可以用来创建转换或自定义的配置工具，以帮助管理使用RouterOS的路由器。

使用API需要RouterOS版本3.x或更高的版本。

默认情况下，API使用端口8728，默认服务是禁用的。通讯服务的名称是API，请

在IP-SERVER里开启，服务管理的详细信息，请参阅相应的手册部分。

通讯协议：

应用程序与路由器的通信是通过发送和接收路由器的一个或多个编码的句子来

完成的。一个句子是以零字符结尾的单词序列。词是句子以某种方式编码 -（编码

长度是数据的一部分），路由器发送和接收回复并发送这些句子。每个句子发送到路由器

使用API没有特定的顺序，每个命令字是以零字符标记结束的。当路由器

接收到完整的句子（命令字，或多个属性的话，零字符结束），它就开始执行命令，

并将结果返回给应用程序。

API语句：

词是句子的一部分。每个词长都用某种方式编码 - 词长编码跟随词的内容就是一个句

子。词的长度应为将要发送的字节计数（不包括词长编码）。

词长编码如下：

Value of length # of bytes Encoding

0 <= Len <= 0x7F

0x80 <= Len <= 0x3FFF

0x4000 <= Len <= 0x1FFFFF

Len >= 0x10000000

对应的10进制：

1

2

3

5

Len, lowest byte

词长度

Len | 0x8000, two lower bytes

Len | 0xC00000, three lower bytes

Len | 0xE0000000

0xF0 and Len as four bytes

0x200000<=Len <= 0xFFFFFFF 4

本文标签： 管理路由器句子使用发送

版权声明：本文标题：ROS API 中文说明 内容由热心网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：https://m.elefans.com/xitong/1719322254a771152.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。