openclaw/skills/mikrotik-api/references/routeros-api-notes.md

RouterOS API — краткие заметки

• API порты: 8728 (plain), 8729 (secure).
• Коммуникация: sentence из words, конец sentence — zero-length word.
• Первое слово sentence — команда (/path/to/cmd).
• Атрибуты: =name=value.
• API-атрибут: .tag=....
• Query-слова (?) поддерживаются print.

Reply-типы:

• !re — данные
• !done — завершение команды
• !trap — ошибка
• !empty — пустой успех (ROS 7.18+)
• !fatal — фатальная ошибка/закрытие

Логин (post-v6.43):

• /login
• =name=...
• =password=...

Практика:

• В print почти всегда используй .proplist для снижения нагрузки.
• Обрабатывай !trap как ошибку выполнения команды.
• Для конкурентных вызовов маркируй запросы .tag.