De fleste PHP-projekter, der taler med MikroTik, henter en pakke. Til Linkhive, vores ISP-faktureringsplatform, skrev vi i stedet en lille RouterOS API PHP-klient, fordi protokollen er enkel, og hvert routerkald påvirker en kundes tjeneste.
Ord og sætninger
API’et kører over TCP på port 8728 eller TLS på 8729. En kommando er en sætning af ord, og hvert ord sendes med sin længde foran. Routeren svarer med sætninger, der starter med !re for en række, !trap for en fejl, !fatal, når den afbryder forbindelsen, og !done, når den er færdig.
To måder at logge ind på
Siden RouterOS 6.43 sender login navn og adgangskode direkte. Ældre versioner svarer med en challenge, så klienten håndterer begge:
$done = $this->talk(['/login', '=name='.$username, '=password='.$password])['done'];
if (isset($done['ret'])) {
$response = '00'.md5(chr(0).$password.hex2bin($done['ret']));
$this->talk(['/login', '=name='.$username, '=response='.$response]);
}

Hold driveren idempotent
Oven på klienten ligger en driver med én upsert-hjælper: slå posten op efter navn, opdatér den, hvis den findes, og tilføj den ellers. Samme ændring kan derfor køre to gange uden skade, hvilket betyder noget, fordi mislykkede ændringer forsøges igen. En !trap bliver til en undtagelse, og provisioneringslaget fanger den, logger den og markerer abonnementet til nyt forsøg.
Vigtigste pointer
- RouterOS API er enkelt nok til at blive implementeret på omkring to hundrede linjer.
- Understøt begge loginmetoder, hvis dine kunder har ældre routere.
- Gør hver routerskrivning til en upsert, så genforsøg er sikre.
Bemærk, at vores klient ikke verificerer routerens TLS-certifikat, fordi routere normalt har selvsignerede certifikater. Se TLS som kryptering på et netværk, du selv kontrollerer.
Se det i Linkhive live-demoen, eller køb Linkhive på Vibe96. Har du brug for en særlig MikroTik-integration? Lad os tale sammen, eller se vores Laravel-udvikling.