Аркадный зал Школы Империи

Спецификация погодного API

Публичный контракт Weather 1.7 сохраняет модели источников, интервалов и форматов из семейства API 1.x. Версия документа и значение schema — разные величины. Базовый адрес: https://games.oopssre.ru/assets/arcade/views/.

Все относительные пути из погодных JSON разрешаются от этого базового адреса, включая пути внутри вложенного прогноза. Их нельзя разрешать от папки самого forecast-*.json.

Ресурсы и схемы

РесурсПуть от базового адресаСхема
Каталогmanifest-v3.jsonschema: 3
Реальное текущее состояниеweather/C/current.jsonschema: 1
Реальный прогноз форматаweather/C/forecast-D.jsonschema: 1
Текущее состояние мираweather/C/sources/game-world/current.jsonschema: 1
Прогноз мираweather/C/sources/game-world/forecast-D.jsonschema: 1
Подготовленные изображенияweather/C/assets.jsonschema: 1
Прямой текущий JPEGweather/C/current-D.jpgИзображение
Прямой JPEG мираweather/C/sources/game-world/current-D.jpgИзображение

C — ID коллекции, D — объявленный ключ формата. Адреса прямых JPEG используются только при их наличии в опубликованных данных. Поддержка формата и готовность конкретного изображения проверяются отдельно.

Источник и интервалы

Коллекция определяет рисунки, source_id — источник погоды. Публичные источники семейства API: real и game-world. Реальному источнику не требуется дополнительная папка /sources/real/. world_id относится к игровому окружению, location_revision — к ревизии местоположения и его параметров.

Для подписи окружения используется source.setting с запасным вариантом source.name. Текущие сезон, свет и world_date берутся из интервала. Время интервала задаёт срок применения кадра; таймер клиента должен переключать изображение по границам, а не только раз в сутки.

Обновления и отсутствие данных

Один постоянный URL может отдавать новые байты. Различать их нужно по опубликованным версии и SHA-256. Если прежний JSON ожидает старую сумму, а сервер уже отдаёт другой файл, следует обновить каталог и прогноз. Несовпавший файл не считается проверенным кадром.

При недоступности используются явные статусы API. Ещё действующий совместимый прогноз можно продолжить при сетевом сбое; просроченный нельзя произвольно продлевать. Общая иллюстрация weather_fallback — отдельный материал недоступности, а не новое погодное состояние или JPEG нужного размера.

Небесные признаки

Время суток и события Солнца зависят от даты, координат и явного часового пояса. Фаза Луны — одно из восьми объявленных значений. Если расписание содержит более точные границы, клиент следует ему. Локальные дата и часы устройства не должны подменять календарь игрового мира.

Нормативные подробности совместимого клиента приведены в полном погодном контракте. Связанные спецификации: динамические обои, форматы.

Совместимые расширения

Астрономические события передаются необязательным astronomy.events. Прежние поля и интервалы сохраняются; сведения об астрономии имеют собственные статус и срок актуальности. См. астрономические данные и расширения.

Порядок чтения: Оглавление · Назад: Музыкальный API и идентичность треков · Далее: Погодные клиенты: полный контракт 1.7