NetMay RouterOS中文教程系列 ROS API中文使用手册.pdfVIP

www.NETMAY.com 前言： 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 的 www.NETMAY.com www.NETMAY.com 沟通，收集信息，调整配置和管理路由器。 API 紧随命令行界面（CLI ）的语法。 它可以用来创建转换或自定义的配置工具，以帮助管理使用RouterOS 的路由器。 使用API 需要RouterOS 版本3.x 或更高的版本。 默认情况下，API 使用端口8728，默认服务是禁用的。通讯服务的名称是API ，请 在IP-SERVER 里开启，服务管理的详细信息，请参阅相应的手册部分。 通讯协议： 应用程序与路由器的通信是通过发送和接收路由器的一个或多个编码的句子来 完成的。一个句子是以零字符结尾的单词序列。词是句子以某种方式编码 - （编码 长度是数据的一部分），路由器发送和接收回复并发送这些句子。每个句子发送到路 由器 使用API 没有特定的顺序，每个命令字是以零字符标记结束的。当路由器 接收到完整的句子（命令字，或多个属性的话，零字符结束），它就开始执行命令， 并将结果返回给应用程序。 API 语句： 词是句子的一部分。每个词长都用某种方式编码 - 词长编码跟随词的内容就是一 个句子。词的长度应为将要发送的字节计数（不包括词长编码）。 词长编码如下： Value of length # of bytes Encoding 0 = Len = 0x7F 1 Len, lowest byte 词长度 0x80 = Len = 0x3FFF 2 Len | 0x8000, two lower bytes 0x4000 = Len = 0x1FFFFF 3 Len | 0xC00000, three lower bytes 0x200000=Len = 0xFFFFFFF 4 Len | 0xE0000000 Len = 0