JSON API времени

✓ Без рекламы, без трекеров, без cookie-баннеров.

Открытый API для разработчиков. Возвращает текущее время и часовой пояс для любого из 9 100+ населённых пунктов России в нашей базе.

Эндпоинт

GET https://100time.ru/api/v1/time/<type>/<slug>.json

Пример запроса

curl https://100time.ru/api/v1/time/g/magnitogorsk.json

Пример ответа

{
  "slug": "magnitogorsk",
  "type": "g",
  "name": "Магнитогорск",
  "region": "Челябинская область",
  "iana_tz": "Asia/Yekaterinburg",
  "utc_offset": "+05:00",
  "moscow_offset_hours": 2,
  "lat": 53.4078,
  "lng": 58.9794,
  "population": 413351
}

Особенности

• Без ключей API. Регистрироваться не нужно — публичный endpoint.
• Без явных лимитов. Разумное использование (до ~100 запросов в час с одного IP) не ограничивается. При обнаружении DDoS или scraping всей базы — ограничение по IP на 1 час.
• CORS открыт — можно вызывать с любого фронта.
• Cache-Control: max-age=3600 — данные стабильные (часовой пояс и координаты редко меняются), можно агрессивно кешировать.
• Атрибуция приветствуется, но не обязательна. Ссылка на 100time.ru — спасибо.

Типы населённых пунктов

Префикс	Полное название	Количество
g	город	1 125
p	посёлок	2 596
s	село	4 263
d	деревня	355
h	хутор	231
st	станица	394
aul	аул	76
sl	слобода	22
ulus	улус	17
n	наслег	16
m	местечко	3
o	остров	2

Получение текущего времени

API возвращает часовой пояс города, а текущее время вы можете получить через Intl.DateTimeFormat в браузере или через NTP-сервер на сервере:

fetch('https://100time.ru/api/v1/time/g/magnitogorsk.json')
  .then(r => r.json())
  .then(data => {
    const now = new Intl.DateTimeFormat('ru-RU', {
      timeZone: data.iana_tz, hour12: false,
      hour: '2-digit', minute: '2-digit', second: '2-digit'
    }).format(new Date());
    console.log('Время в ' + data.name + ': ' + now);
  });

Лицензия данных

Координаты и часовые пояса основаны на GeoNames (CC BY 4.0) и IANA tz database. Использование наших данных свободно.