Платформа — itd.platform

Версии приложений, журнал изменений, анонсы, баннер события и статус сервисов. version() и status() всегда выполняются без автоматической авторизации. Остальные методы используют обычную политику клиента и при наличии сессии отправляют Bearer-токен.

Методы

version(): Promise<PlatformVersions>

Минимальные и актуальные версии приложений Android и iOS. Endpoint публичный, поэтому автоматическая авторизация не отправляется. updateUrl возвращается без преобразования.

const versions = await itd.platform.version();

console.log(versions.android.minVersion);
console.log(versions.android.latestVersion);
console.log(versions.android.updateUrl);

changelog(): Promise<ChangelogEntry[]>

Журнал изменений платформы. См. ChangelogEntry.

announcements(): Promise<Announcement[]>

Анонсы на главной странице. См. Announcement.

portal(): Promise<Portal>

Баннер текущего события — виджет «портал». См. Portal. Также в Поиск и обнаружение.

status(): Promise<PlatformStatus>

Состояние сервисов за последние 90 суток. Идёт на отдельный хост статус.итд.com без авторизации, ответ кэшируется сервером на минуту. Работает из браузера напрямую (в отличие от остального API). См. PlatformStatus.

Статус: разбор истории

История по суткам приходит разреженным объектом (days: Record<string, StatusDay>); сутки без данных сервер пропускает. Ровный массив на 90 элементов даёт функция из корня пакета:

statusDays(service: ServiceStatus): (StatusDay | null)[]

Индекс — сколько суток назад: [0] — сегодня, пропуски равны null. См. ServiceStatus, StatusDay, ServiceState.

date_key задаёт сутки по UTC. Время внутри готовых строк lines[].text указано по Москве; отдельные структурированные поля начала и длительности инцидента сервер не возвращает.

const status = await itd.platform.status();
const auth = status.services.find((s) => s.id === 'auth');
const days = auth ? statusDays(auth) : [];
days[0]?.uptime;   // доступность за сегодня

Типы версий

interface PlatformClientVersion {
  minVersion: string;
  latestVersion: string;
  updateUrl: string;
}

interface PlatformVersions {
  android: PlatformClientVersion;
  ios: PlatformClientVersion;
  [client: string]: PlatformClientVersion;
}