A API de Atividades ao Vivo do iOS para tudo que fala HTTP
O PushWard é uma API para as Atividades ao Vivo da Apple: envie uma única requisição HTTP e ela aparece ao vivo na Tela Bloqueada e na Dynamic Island do iPhone, atualizando em tempo real e saindo sozinha quando a tarefa termina. Sem código ActivityKit, sem Xcode, sem revisão da App Store do seu lado.
O que é uma Atividade ao Vivo?
Uma Atividade ao Vivo é um recurso do iOS que mostra informações ao vivo, visíveis de relance, na Tela Bloqueada, na Dynamic Island e no modo Em Espera — sem que o destinatário abra um app. Diferente de uma notificação push, que aparece uma vez e some na lista, uma Atividade ao Vivo fica fixada e atualiza em tempo real: um build avançando pelas etapas, um cronômetro em contagem regressiva, uma entrega se aproximando. O PushWard transforma uma única requisição HTTP em uma delas.
As Atividades ao Vivo da Apple, sem ActivityKit
As Atividades ao Vivo são um recurso do iOS da Apple introduzido no iOS 16.1: superfícies em tempo real, visíveis de relance, fixadas na Tela Bloqueada e na Dynamic Island. Criar uma normalmente significa publicar o seu próprio app iOS com uma extensão de widget do ActivityKit, solicitar tokens push-to-start e falar você mesmo com o APNs. O PushWard substitui tudo isso por uma única API REST: o app do PushWard renderiza a sua Atividade ao Vivo, e uma única requisição HTTP a inicia, atualiza ou encerra.
Como a API funciona
Crie uma atividade, inicie, atualize e encerre — tudo pela API REST do PushWard com a sua chave de integração. Qualquer serviço capaz de enviar uma requisição HTTP pode controlar o que as pessoas veem de relance. Não há certificados APNs nem código de cliente para escrever; o PushWard cuida da entrega via Apple Push Notification service.
# 1. Create an activity
curl -X POST https://api.pushward.app/activities \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "slug": "deploy", "name": "Deploy to production" }'
# 2. Start the Live Activity on the Lock Screen
curl -X PATCH https://api.pushward.app/activities/deploy \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/merge-patch+json" \
-d '{ "state": "ongoing", "content": {
"template": "generic", "progress": 0.2,
"state": "Building...", "accent_color": "cyan"
} }'
# 3. End it when the task is done
curl -X PATCH https://api.pushward.app/activities/deploy \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/merge-patch+json" \
-d '{ "state": "ended", "content": {
"template": "generic", "progress": 1, "state": "Deployed"
} }'Um template para cada tipo de atualização
Escolha entre templates de Atividade ao Vivo feitos para tarefas diferentes — uma barra de progresso genérica, uma contagem regressiva, uma sequência de etapas, um alerta, um medidor, uma sparkline de linha do tempo, um quadro de blocos, um log de eventos ao vivo ou um player de mídia com botões de reprodução. Cada um tem um layout ajustado para a Tela Bloqueada e a Dynamic Island.
Funciona com a sua stack
Envie Atividades ao Vivo direto das ferramentas que você já usa. Bridges prontas e um relay de webhooks hospedado cobrem alertas do Grafana, automações do Home Assistant, GitHub Actions, downloads do SABnzbd, impressões da Bambu Lab, syncs do ArgoCD e qualquer outra coisa que consiga enviar JSON.
Perguntas frequentes
Esta é a API oficial de Atividades ao Vivo da Apple?
Não. O framework oficial da Apple é o ActivityKit, que exige criar e publicar o seu próprio app iOS. O PushWard é uma API de Atividades ao Vivo do iOS independente: ele entrega as suas atualizações via Apple Push Notification service ao app do PushWard, que as renderiza na Tela Bloqueada e na Dynamic Island.
Posso iniciar uma Atividade ao Vivo a partir de um servidor?
Sim — esse é justamente o ponto. Qualquer servidor, script ou automação capaz de enviar uma requisição HTTP pode criar, iniciar, atualizar e encerrar uma Atividade ao Vivo. O PushWard cuida do fluxo push-to-start da Apple por você, então a atividade aparece sem que o destinatário abra o app.
Os destinatários precisam ter um app instalado?
Sim — o app iOS gratuito do PushWard renderiza a Atividade ao Vivo. Não há nada para você criar, assinar ou enviar à App Store; os destinatários instalam o PushWard uma vez e as suas requisições comandam a Tela Bloqueada deles.
Quais iPhones são compatíveis com as Atividades ao Vivo?
O app do PushWard requer o iOS 26 ou posterior. Nos iPhones com Dynamic Island, a Atividade ao Vivo se encaixa na ilha; nos modelos sem ela, aparece na Tela Bloqueada e no modo Em Espera.
Experimente a API de Atividades ao Vivo do iOS
Veja uma Atividade ao Vivo chegar em um iPhone simulado no playground, ou leia o guia de primeiros passos e envie a sua primeira com curl em poucos minutos.