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

> Un'API per notifiche push trasforma una singola richiesta HTTP in un avviso sul telefono. Cosa fa, i due tipi di prodotto che condividono questo nome, come è fatta una richiesta e cosa controllare prima di sceglierne una.

*04.10.2026*

<!-- source: https://pocketalert.app/it/blog/what-is-a-push-notification-api -->

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](/blog/how-push-notifications-work-apns-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:

```bash
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](/use-cases/curl-push-notifications) 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](/blog/create-your-first-webhook-url) 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](/tools/cli)), oppure uno strumento `create_message` che Claude o Cursor chiama quando termina un'attività lunga ([MCP](/tools/mcp)).

## Quando ti servirebbe

La maggior parte degli avvisi rientra in alcuni gruppi:

- **Qualcosa si è rotto.** Un server ha smesso di rispondere, un cron job è terminato con errore, un backup non è stato eseguito. Vedi [avvisi per cron job](/use-cases/cron-job-alerts) e [monitoraggio dei server](/use-cases/server-monitoring).
- **Qualcosa è terminato.** Un deploy, una build lunga, una stampa 3D di 12 ore, l'attività di un agente AI. Vedi [avvisi di deployment](/use-cases/deployment-alerts).
- **È successo qualcosa che ti interessa.** Un pagamento, una registrazione, l'invio di un form. Vedi [avvisi di pagamento](/use-cases/payment-alerts) e [avvisi di registrazione](/use-cases/signup-alerts).
- **Sta per succedere qualcosa.** Un certificato che scade tra 14 giorni. Vedi [avvisi di scadenza SSL](/use-cases/ssl-expiration-alerts).

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](/alternatives), 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](/get-app), 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](/pricing).

### 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](/blog/push-notifications-vs-sms) e [Notifiche push vs avvisi email](/blog/push-vs-email-alerts).

[Crea un account gratuito](/signup), copia la tua chiave API, e il comando curl qui sopra è la tua prima push.
