Torna al blog

Cos'è un'API per notifiche push, e quando ti serve una?

Cos'è un'API per notifiche push, e quando ti serve una?

Un'API per notifiche push è un servizio web che mostra un messaggio sulla schermata di blocco del telefono quando il tuo codice glielo chiede. Invii una sola richiesta HTTP con un titolo e un testo, il servizio la passa ad Apple o Google, e il telefono la mostra in pochi secondi, che un'app sia aperta o no.

Questa è l'idea di base. I dettagli dipendono da chi deve ricevere la notifica e da quanta parte della catena di consegna vuoi gestire tu.

Due cose diverse con lo stesso nome

Cerca "API notifiche push" e troverai due tipi di prodotto che si sovrappongono poco.

Piattaforme che inviano notifiche ai tuoi utenti. Firebase Cloud Messaging, Apple Push Notification service, OneSignal e simili. Crei un'app mobile, la pubblichi su App Store e Google Play, raccogli un token del dispositivo da ogni installazione e invii notifiche di prodotto o promozionali a migliaia di persone. L'API è l'ultimo passo di un progetto lungo.

Servizi che inviano notifiche a te. Pocket Alert, Pushover, ntfy e altri. L'app esiste già: la installi sul tuo telefono, ottieni una chiave API e invii avvisi da script, server e altri servizi. Non c'è nulla da pubblicare né token da raccogliere. Un deploy è terminato, un backup è fallito, è arrivato un pagamento.

Questa guida riguarda il secondo tipo. Se stai costruendo un'app consumer e devi raggiungere i suoi utenti, ti serve il primo tipo, e gran parte di quello che segue non ti riguarderà.

Cosa succede quando ne invii una

Quattro passaggi, la maggior parte invisibili:

  1. Il tuo codice invia una richiesta HTTPS al servizio con un titolo, un messaggio e la tua chiave API.
  2. Il servizio controlla la chiave, salva il messaggio e decide dove va: quali dei tuoi dispositivi, con quale priorità.
  3. Passa la notifica alla rete push della piattaforma, APNs per iPhone e Firebase Cloud Messaging per Android.
  4. Apple o Google la consegnano attraverso la connessione che ogni telefono tiene già aperta verso di loro, e il telefono la mostra.

I passaggi 3 e 4 sono il motivo per cui le push funzionano con l'app chiusa senza consumare la batteria: il telefono non interroga mai nessuno. Il percorso completo è spiegato in Come funzionano le notifiche push: APNs e FCM.

Perché non parlare direttamente con Apple e Google?

Puoi farlo, se hai una tua app in entrambi gli store. Per inviare notifiche al tuo telefono senza intermediari ti servono:

  • Un'iscrizione all'Apple Developer Program e un'app iOS con l'entitlement per le push, più un progetto Firebase e un'app Android per l'altra metà.
  • Una chiave di firma APNs e un account di servizio Firebase, e codice che firmi le richieste per ciascuno.
  • Un modo per raccogliere i token dei dispositivi dall'app e tenerli aggiornati quando cambiano.
  • Due formati di richiesta, due modelli di priorità e due serie di codici di errore.

È un progetto sensato quando l'app è il tuo prodotto. È troppa infrastruttura per "dimmi quando il cron job fallisce". Un servizio di notifiche push ha già fatto tutto questo una volta, per tutti.

Com'è fatta una richiesta

Con Pocket Alert, inviare una notifica è una singola POST autenticata:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'

La risposta è 201 Created con il messaggio salvato e la priorità con cui è stato inviato. La stessa richiesta funziona con qualsiasi linguaggio che abbia un client HTTP, e Inviare notifiche push con curl contiene altre ricette da terminale.

Solo title e message sono obbligatori. I campi opzionali più utili per gli avvisi:

  • level imposta quanto forte arriva: silent, low, default, high o critical.
  • actions aggiunge fino a tre pulsanti di azione alla notifica: aprire un URL, eseguire una richiesta HTTP o copiare un valore.
  • send_at o delay la consegna più tardi invece che subito (piani a pagamento).
  • application_id e device_id indicano a quale progetto appartiene e quale telefono la riceve.

Tre modi di entrare, non solo l'API

Un'API per notifiche push è più utile quando non devi scrivere codice per ogni sorgente.

  • L'API HTTP per i tuoi script, job e app.
  • URL webhook per i servizi che inviano già webhook. GitHub, Stripe, Grafana o Sentry inviano il loro JSON a un webhook di Pocket Alert, e segnaposto come %repository.name% estraggono dei campi e li inseriscono nella notifica, senza codice intermedio. Crea il tuo primo URL webhook ti guida passo passo.
  • La CLI e il server MCP per il terminale e per gli agenti AI: pocketalert send "Build done" "All tests passed" da una shell (CLI), oppure uno strumento create_message che Claude o Cursor chiama quando termina un'attività lunga (MCP).

Quando ti servirebbe

La maggior parte degli avvisi rientra in alcuni gruppi:

Il filo comune è un evento di cui qualcuno dovrebbe sapere subito, non alla prossima volta che apre una dashboard o la posta.

Cosa controllare prima di sceglierne una

Ogni servizio in questo ambito invia una push a partire da una richiesta HTTP. Le differenze stanno in tutto il resto:

  • Piattaforme. Alcuni funzionano solo su iPhone (Bark, The Notification App), e l'unica app ufficiale di Gotify è per Android. Se chi deve ricevere l'avviso ha l'altro telefono, la questione è chiusa.
  • Livelli di priorità. Un backup fallito può suonare diversamente da una nuova registrazione? Un avviso critico può superare la modalità Non disturbare?
  • Webhook in ingresso. Un servizio può inviare il proprio JSON, o ogni sorgente richiede uno script che lo rimodelli?
  • Cronologia e log. Quando un avviso non è arrivato, c'è una traccia della chiamata e di cosa le è successo?
  • Limiti e prezzi. Al giorno, al mese o a vita, e cosa succede quando raggiungi il limite.
  • Chi lo gestisce. Un servizio ospitato, o un server che mantieni tu.

Confrontiamo Pocket Alert con Pushover, ntfy, Pushbullet, Bark, Gotify e altri proprio su questi punti in Alternative, indicando anche dove ciascuno è la scelta migliore.

FAQ

Un'API per notifiche push è la stessa cosa di Firebase Cloud Messaging?

FCM è un'API per notifiche push: quella che Google fornisce per le app che costruisci e pubblichi. Servizi come Pocket Alert si appoggiano su FCM e APNs e si occupano dell'app, delle chiavi e dei token dei dispositivi, così tu devi solo fare la richiesta HTTP.

Devo costruire un'app mobile?

No, per avvisi destinati a te o al tuo team. Installi un'app già esistente, come Pocket Alert per iPhone o Android, e invii a quella. Ti serve una tua app solo per inviare notifiche ai tuoi utenti.

È gratuito?

Molti servizi hanno un piano gratuito. Quello di Pocket Alert prevede 50 messaggi al giorno senza carta di credito, sufficienti per la maggior parte degli avvisi personali, e i piani a pagamento partono da 6 $ al mese per 1.000 al giorno. Dettagli nella pagina dei prezzi.

Quanto è veloce la consegna?

Di solito da pochi secondi dalla richiesta alla schermata di blocco. Apple e Google però non garantiscono i tempi: un telefono senza segnale o in una modalità di risparmio energetico rigida riceverà la notifica quando si riconnette.

Push, SMS o email?

Push per le cose che richiedono attenzione subito, email per riepiloghi e registrazioni, SMS quando la persona non ha un'app sullo smartphone. I compromessi sono spiegati in Notifiche push vs SMS e Notifiche push vs avvisi email.

Crea un account gratuito, copia la tua chiave API, e il comando curl qui sopra è la tua prima push.

Condividi questo articolo