API віджетів на iOS для всього, що говорить HTTP

PushWard — це API для віджетів iOS від Apple: один раз оголосіть віджет, а далі керуйте початковим екраном, замкненим екраном і режимом «Очікування» iPhone звичайними HTTP-запитами. Кожне оновлення запускає оновлення WidgetKit за push — жодних опитувань, жодного коду WidgetKit, жодного Xcode, жодної перевірки в App Store з вашого боку.

Що таке віджет початкового екрана iOS?

Віджети — це поверхні Apple для швидкого погляду: маленькі, завжди видимі плитки на початковому екрані, замкненому екрані та в режимі «Очікування» iPhone, які показують інформацію без відкриття застосунку. Їх створюють за допомогою WidgetKit — фреймворку Apple, що працює на пристрої, — і зазвичай кожен належить застосунку, який вам довелося б самому створити, підписати й випустити. Віджети PushWard інші: їх відображає застосунок PushWard, а їхній вміст надходить із ваших викликів API — показання сенсора, перевірка стану сервера, лічильник деплоїв, будь-що, що можна надіслати як JSON.

Як працює API

Зареєструйте віджет запитом POST, потім оновлюйте його запитом PATCH — оце й увесь цикл. Кожне оновлення надсилає легкий push через Apple Push Notification service, який велить WidgetKit перезавантажити стрічку віджета, тож нове значення з'являється без жодного опитування з боку віджета. Необов'язковий обмежувач push на віджет об'єднує джерела, що надсилають дані сплесками.

Реєстрація та оновлення віджета через HTTP

# 1. Register a widget
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "cpu-load", "name": "CPU Load", "content": {
    "template": "progress", "value": 0.42,
    "label": "load avg", "icon": "cpu", "accent_color": "cyan"
  } }'

# 2. Update it - WidgetKit refreshes the widget
curl -X PATCH https://api.pushward.app/widgets/cpu-load \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "content": { "value": 0.78, "accent_color": "orange" } }'

Десять шаблонів віджетів

Оберіть макет під дані: одиночне значення, смуга прогресу, світловий індикатор стану, шкала, список показників, спарклайн тренду, зворотний відлік, рівень заряду, розклад або потік між точками. Кожен шаблон нативно відображає застосунок PushWard, тож ваші дані потрапляють у відточений макет без жодної роботи над дизайном.

Переглянути шаблони віджетів →

Інтерактивні віджети, що діють

Віджет може нести до трьох дій за торканням: надіслати тихий вебхук, не полишаючи початковий екран, перейти глибоким посиланням в інший застосунок або відкрити URL. Перезапустіть сервер, запустіть Швидку команду чи підтвердьте сповіщення просто з віджета — застосунку PushWard навіть не треба відкриватися.

Працює з вашим стеком

Живіть віджети з інструментів, які ви вже використовуєте: сповіщення Grafana перемикає індикатор стану, автоматизація Home Assistant оновлює температуру, завдання GitHub Actions збільшує лічильник деплоїв, cron-скрипт публікує вік резервної копії. Усе, що вміє надіслати HTTP-запит, може володіти віджетом.

Усі інтеграції →

Віджети та Дії наживо разом

Віджети та Дії наживо доповнюють одне одного: віджет — це постійний фоновий статус, який лишається на початковому екрані, доки його не приберуть, а Дія наживо — завдання з початком і кінцем, що на час виконання закріплюється на замкненому екрані та в Dynamic Island. PushWard керує обома через той самий REST API і той самий ключ інтеграції.

Дізнатися про API Дій наживо →

Часті запитання

Це офіційний API WidgetKit від Apple?

Ні. WidgetKit — це фреймворк Apple, що працює на пристрої, і користуватися ним напряму означає створити й випустити власний iOS-застосунок із віджет-розширенням. PushWard — незалежний API віджетів для iOS: застосунок PushWard постачає розширення WidgetKit, а ваші HTTP-запити вирішують, що воно показує.

Як швидко оновлюються віджети?

Кожен PATCH запускає легкий push, який велить WidgetKit перезавантажити віджет, тож оновлення зазвичай надходять за лічені секунди. Обмежувач push на віджет (від 1 секунди до 1 години) об'єднує джерела зі сплесками, утримуючи оновлення в межах бюджету, який iOS виділяє розширенню.

Чи працюють віджети на замкненому екрані та в режимі «Очікування»?

Так. Віджети PushWard можна додати на початковий екран, замкнений екран і в режим «Очікування» iPhone. Компактні аксесуарні слоти замкненого екрана відображають стислий макет, а торкання відкриває налаштовану дію за торканням.

Чи потрібен отримувачам встановлений застосунок?

Так — безплатний iOS-застосунок PushWard (iOS 26 або новіша) відображає віджети й реєструє їх у галереї віджетів iOS. Вам нічого не треба створювати чи надсилати в App Store.

Спробуйте API віджетів для iOS

Зберіть корисне навантаження віджета в playground і подивіться, як він відобразиться на симульованому iPhone, або прочитайте посібник із початку роботи й зареєструйте перший віджет за допомогою curl за кілька хвилин.