Быстрый старт

Production API и документация доступны на https://wxs.weatherpaper.org.

1. Проверьте сервис

curl "https://wxs.weatherpaper.org/health"

Успешный ответ подтверждает доступность production backend. В сборках с раздельными Kubernetes-style probes готовность хранилища дополнительно проверяет /health/ready.

2. Зарегистрируйтесь

curl -sS -X POST "https://wxs.weatherpaper.org/api/account/register" \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"change-me-123"}'

Скопируйте значение api_key: полный секрет показывается один раз.

export WXS_API_KEY='wxs_...'

3. Активируйте доступ

Для погодных полей по умолчанию нужна активная месячная подписка. Активируйте выданный оператором купон в личном кабинете /account или через API:

curl -sS -X POST "https://wxs.weatherpaper.org/api/account/redeem" \
  -H "X-API-Key: $WXS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"code":"YOUR-CODE"}'

4. Получите прогноз в точке

curl -sS "https://wxs.weatherpaper.org/point?lat=45.22&lon=39.68&var=t2m&group=forecast/aurora15" \
  -H "X-API-Key: $WXS_API_KEY"

Ответ содержит каноническое имя поля, сроки, значения и источник: patch для подходящего регионального прогноза или global для глобального слоя.

Что дальше

• Получение доступа — подписка, купоны и жизненный цикл ключей.
• Точечный прогноз — параметры, алиасы и пример Python.
• Zarr и экспорт — работа с массивами без загрузки всей планеты в RAM.