DB-Master5
Документация Получить ключ
Возможности

Единый предсказуемый API для дистрибуции датасетов

DB-Master5 распространяет курируемые эталонные датасеты по сети distribution-узлов. Одна схема, один ответ — куда бы ни попал ваш запрос.

⚡

Непрерывная репликация

Каждый датасет реплицируется на все distribution-узлы. Запрос попадает на ближайший узел через anycast-маршрутизацию, либо закрепите узел поддоменом.

🔑

Простая авторизация

Один Bearer-токен в заголовке Authorization. Лимиты по ключу возвращаются в стандартных заголовках ответа.

📦

Стабильные схемы

Датасеты версионируются под /v1. Несовместимые изменения выходят под новым путём — никогда не молча на месте.

🛰️

Сеть distribution-узлов

Узлы с ролями primary, replica и edge. Позвольте anycast выбрать ближайший узел или обращайтесь к main, a2, b3 напрямую.

📈

Наблюдаемость

Каждый ответ несёт X-Request-Id и X-DbMaster5-Region; защищённые эндпоинты добавляют заголовки лимитов.

📚

OpenAPI

Полная спецификация OpenAPI 3 документирует каждый эндпоинт и питает справочную документацию.

📡

Живой поток изменений

SSE-канал доставляет каждое изменение датасета по одному постоянному соединению — без опроса и без расхода лимитов.

⬇️

Снапшоты и репликация

Полные мультигигабайтные снапшоты и почасовые инкрементальные диффы (jsonl.zst), непрерывно реплицируемые на каждый узел.

Согласованные версионируемые ответы

Каждый узел возвращает идентичный JSON на один и тот же запрос. SDK не требуется — обычный HTTPS и JSON, с Bearer-токеном для защищённых эндпоинтов.

  • Стандартный конверт ошибки при любом сбое
  • Заголовки лимитов на защищённых эндпоинтах
  • Метки времени ISO 8601 и имена таймзон IANA
  • Фильтрация стран по коду ISO или валюте

Читать документацию

# Look up a country by ISO code
curl -s https://main.db-master5.info/v1/countries?code=RU \
  -H "Authorization: Bearer $DBM5_KEY"

# Current time in a specific timezone
curl -s "https://main.db-master5.info/v1/time?tz=Europe/Moscow" \
  -H "Authorization: Bearer $DBM5_KEY"

Датасеты и эндпоинты

Курируемые эталонные данные за небольшим стабильным набором GET-эндпоинтов.

ЭндпоинтАвторизацияЧто возвращает
GET /v1/healthНетПроверка живости с узлом и меткой времени.
GET /v1/statusНетСтатус distribution-узла, узлы онлайн и задержка.
GET /v1/regionsНетВсе distribution-узлы с ролью, уровнем и покрытием датасетов.
GET /v1/timezonesBearerТаймзоны IANA с актуальными смещениями UTC.
GET /v1/countriesBearerКоды ISO 3166, столицы, валюты, телефонные коды.
GET /v1/timeBearerТекущее время и смещение для таймзоны IANA.
GET /v3/api/streamBearerЖивой SSE-поток изменений по постоянному соединению.
GET /v3/api/snapshotsНетПолные и инкрементальные снапшоты со ссылками на скачивание.

Попробуйте с ближайшего узла

Бесплатный тариф включает 100 тыс. запросов в месяц. Без карты.

Получить API-ключ