Red Atlas

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}
status running, 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