Получение доступа

Варианты доступа

Ресурс	Доступ
Карта `/map`, каталог и PNG-тайлы	Публичный, read-only
Профиль и каталог групп	Валидный API-ключ
`/point`, `/data`, `/api/export`	Ключ + активная подписка
Метаданные и выгрузка EO-латентов	Ключ; операции данных списывают кредиты
Админские маршруты и запуск расчётов	Только оператор сервиса

В стандартной конфигурации погодные данные работают в режиме weather_billing="subscription": активная подписка разрешает чтение без оплаты каждого чанка. Legacy-режим credits может быть включён оператором для pay-per-use.

Регистрация и вход

POST /api/account/register создаёт пользователя и первый ключ. Пароль должен содержать не менее шести символов. POST /api/account/login проверяет пароль и создаёт новый ключ с меткой login; это не возврат ранее созданного секрета.

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

Подписка

Доступ может выдать оператор на нужный срок или купон с числом месяцев. Статус виден в GET /api/account/me: проверяйте subscription.subscribed и subscription.until.

curl "https://wxs.weatherpaper.org/api/account/me" -H "X-API-Key: $WXS_API_KEY"

401 означает отсутствующий/некорректный ключ, 402 — ключ валиден, но тариф не разрешает операцию. Наличие положительного кредитного баланса само по себе не заменяет подписку.

Отдельный ключ на приложение

curl -X POST "https://wxs.weatherpaper.org/api/account/keys" \
  -H "X-API-Key: $WXS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"label":"production-etl"}'

Отозвать ключ можно через DELETE /api/account/keys/{key_id}. Используйте разные ключи для ноутбуков, ETL и production-сервисов: это позволяет отозвать один клиент без остановки всех.