API Documentation

Бесплатные API для разработчиков. Написаны мной; данные получаются от сторонних сервисов (Open-Meteo, ipinfo.io). Документация, примеры и статус.

Watch Weather API

API доступно

Бесплатное API для получения погоды. Используется в приложении Weather Scope (Apple). Данные о погоде и геолокации — от Open-Meteo и ipinfo.io.

Обзор

Watch Weather API отдаёт актуальные данные о погоде для любой точки. Сервис бесплатен для использования; написан мной, данные получаются от сторонних провайдеров (см. «Источники данных»).

Базовый URL: https://api.zerikc.ru

Формат данных: JSON

Rate Limit: 100 запросов в час, 10 в минуту на IP

Источники данных

Погодные данные и геолокация получаются от следующих сервисов:

  • Open-Meteo (open-meteo.com) — прогноз погоды, обратная геокодировка по координатам, индекс качества воздуха (AQI). Бесплатный API без ключа.
  • ipinfo.io (ipinfo.io) — определение локации по IP-адресу.

Координаты и IP передаются только для запроса погоды и не сохраняются на моих серверах. Кэширование — на стороне сервера (краткосрочно) и у клиента.

Эндпоинты

GET /weather/v1/current
Получение погоды по координатам или по IP (ip=auto для автоопределения).

Параметры запроса

Параметр Тип Обязательный Описание
ip string — IP для геолокации или auto. Вместо IP можно передать latitude и longitude.
latitude float — Широта (-90 до 90). В паре с longitude приоритет над ip.
longitude float — Долгота (-180 до 180). В паре с latitude приоритет над ip.
Пример запроса (cURL)
curl -X GET "https://api.zerikc.ru/weather/v1/current?latitude=55.7558&longitude=37.6173"
Пример запроса (JavaScript)
const response = await fetch('https://api.zerikc.ru/weather/v1/current?latitude=55.7558&longitude=37.6173'); const data = await response.json();
Пример запроса (Python)
import requests response = requests.get( 'https://api.zerikc.ru/weather/v1/current', params={'latitude': 55.7558, 'longitude': 37.6173} ) data = response.json()

Параметры для запроса

GET /weather/v1/health
Проверка статуса API. Используется для мониторинга доступности сервиса.
Пример запроса
curl -X GET "https://api.zerikc.ru/weather/v1/health"

Использование

Watch Weather API используется в приложении Weather Scope для всех платформ Apple:

  • iOS
  • iPadOS
  • macOS
  • tvOS
  • visionOS

API бесплатен для использования. Запросы обрабатываются моими серверами; данные о погоде — от Open-Meteo, геолокация по IP — от ipinfo.io. Координаты не сохраняются. Погода кэшируется на устройстве.

Общая информация

Базовый URL: https://api.zerikc.ru

Формат данных: JSON

Rate Limit: 100 запросов в час, 10 в минуту на IP

Статус API

Загрузка информации о статусе...