API
Всё, что видно в атласе, отдаётся в JSON без ключа. Адрес: https://atlas.redstudio.site/api/v1. Если используете данные, поставьте ссылку на Red Atlas.
Лимиты
120 запросов в минуту с одного адреса, 6 живых проверок за 10 минут, 10 отчётов о блокировке в час. При превышении придёт ответ 429 и заголовок Retry-After. Ответы одной живой проверки кэшируются на 10 минут.
Статусы
open «Открывается из России», partial «Открывается не из всех сетей», mixed «Закрыты отдельные адреса» (из России закрыта часть проверенных адресов подсети или единственный проверенный), blocked «Заблокирована в России» (закрыты все проверенные адреса, их не меньше двух, из Европы они открываются), down «Не работает нигде». У подсетей и событий есть готовые фразы: status_text, reason_text и evidence_text (например, «0 из 5 точек в России, из Европы открывается, с 17:21»). Время везде в секундах Unix, UTC.
У хостера поле ranked говорит, хватает ли проверок для доли в процентах (не меньше 20 подсетей или половина сети, но не меньше пяти). Если ranked ложно, показывайте open из measured, а не процент.
Чтение
GET /summary- Сводка: сколько подсетей измерено, доля открытых, время последней проверки, кто стал хуже и лучше за сутки.
GET /hosters- Все хостеры: доля открытых подсетей, сколько измерено, цена, СБП, крипта, KYC.
GET /hosters/{id}- Карточка: факты с источниками, история за 30 дней, последние события, снимок отзывов, тестовые адреса хостера (
tests: подпись, имя машины, статус, время, без адреса). Вrow.open_pctдоля открытых адресов, усреднённая по подсетям, вrow.new_methodчисло подсетей, проверенных по новой методике. GET /hosters/{id}/subnets- Все измеренные подсети хостера с цветом и временем проверки.
GET /subnets/{a.b.c.0}- Одна подсеть /24: статус, сколько точек ответило, история по дням, последние проверки.
y_total,y_open,y_blocked: сколько адресов подсети проверено, открыто и закрыто;addresses: те же адреса под буквами, без самих адресов;method: 1, если подсеть пока проверена по одному адресу, 2, если по новой методике. GET /ip/{ip}- Чей это адрес и что с его подсетью.
GET /asn/{asn}- Счёт по автономной системе.
GET /search?q=- Поиск по адресу, подсети, AS, названию или сайту. Понимает кириллицу и сленг («аэза», «п2г», «хецнер»), опечатки до двух букв и домены: сайт хостера ведёт к хостеру, любой другой домен разрешается в адрес. Ответ
kind:name,ip,net,asn,domainилиnoneс тремя подсказками вsuggestions. POST /hoster-requests- Тело
{"name": "…", "site": "…"}: заявка добавить хостера. Встаёт в очередь на ручную проверку, сама ничего не публикует. Не больше 5 в час. GET /events?since=&hoster= &net= - Подтверждённые смены статуса после события с номером
since. GET /stream?hoster=- Поток событий (Server-Sent Events):
changeна смену статуса,checksна свежие проверки,summaryраз в 15 секунд. ПоддерживаетLast-Event-ID. GET /pick?location=&max_price= &sbp=1 &crypto=1 &no_kyc=1 - Подбор хостера только по измеренным данным: доля открытых подсетей, затем цена в рублях.
GET /weather- Утренняя сводка за прошедшие сутки.
Живая проверка
POST /check- Тело
{"target": "203.0.113.7"}или подсеть"198.51.100.0/24". Ответ{"id": "…"}. Адрес пингуют три точки Globalping в России и две в Европе. GET /check/{id}statusrunning, done или error, вresultответы каждой точки. Обычно готово за 5–10 секунд.
Отчёты о блокировке
POST /reports- Тело
{"ip": "…", "note": "…"}. Мы сами проверим адрес из России и Европы. В счёт идёт только подтверждённая блокировка. GET /reports/{id},GET /reports/stats?days=7- Статус отчёта (new, confirmed, not_confirmed) и счёт по хостерам.
Пример
curl https://atlas.redstudio.site/api/v1/ip/203.0.113.7
curl -N https://atlas.redstudio.site/api/v1/stream?hoster=aeza