API
Открытый JSON API без ключей. Только GET, ответы в UTF-8. Разумные лимиты: не больше нескольких запросов в секунду с одного адреса.
| Метод | Параметры | Описание |
|---|---|---|
/api/v1/status | — | Состояние сервиса, версия, аптайм |
/api/v1/time | — | Время сервера в UTC и unix |
/api/v1/ip | — | Ваш публичный адрес |
/api/v1/subnet | cidr | Параметры сети IPv4 или IPv6 |
/api/v1/split | cidr, prefix | Разбиение сети, до 256 подсетей в ответе |
/api/v1/mask | value | Перевод между префиксом, маской и wildcard |
/api/v1/mac | addr | MAC-адрес в разных нотациях и EUI-64 |
/api/v1/vlsm | cidr, hosts | VLSM: блоки под заданное число хостов |
/api/v1/summarize | prefixes | Агрегация префиксов и общий суперпрефикс |
/api/v1/contains | cidr, addr | Входит ли адрес или сеть в префикс |
/api/v1/range | start, end | Диапазон адресов в набор префиксов |
/api/v1/whoami | — | Адрес и заголовки запроса, как их видит сервер |
/api/v1/notes | — | Список заметок в JSON |
Примеры
curl -s 'https://azhur.net/api/v1/subnet?cidr=10.20.5.7/22'
curl -s 'https://azhur.net/api/v1/split?cidr=192.168.0.0/24&prefix=26'
curl -s 'https://azhur.net/api/v1/mac?addr=0050.56ab.cdef'
curl -s 'https://azhur.net/api/v1/vlsm?cidr=10.0.0.0/24&hosts=100,50,20,2'
curl -s 'https://azhur.net/api/v1/summarize?prefixes=10.0.0.0/24,10.0.1.0/24'Ошибки возвращаются с кодом 400 и полем error.