# Invia una notifica push dal tuo backend.

> Invia notifiche push dal tuo backend con l'API di Pocket Alert. Una sola richiesta HTTP POST autenticata da Node, Python, PHP o Go e la notifica arriva sul tuo telefono in un secondo.

<!-- source: https://pocketalert.app/it/use-cases/api-alerts -->

Ultimo aggiornamento: 2026-08-11

L'API di Pocket Alert invia una notifica push al tuo telefono con una sola POST HTTP autenticata. Lanciala da Node, Python, PHP o Go — titolo, messaggio, livello di priorità — e arriva quasi istantaneamente su iPhone o Android.

## Tre passaggi per la tua prima push via API

1. **Ottieni una chiave API** — Crea una chiave API nella pagina Chiavi API e conservala in una variabile d'ambiente.
2. **Invia una richiesta** — Invia con POST un title e un message in JSON all'endpoint dei messaggi, con la chiave nell'header Token.
3. **Mettilo in produzione** — Il telefono vibra in meno di un secondo. Aggiungi l'indirizzamento per applicazione e dispositivo man mano che le esigenze crescono.

## Notifiche push, a una sola richiesta di distanza

L'API alimenta ogni avviso di Pocket Alert. Collegala al tuo backend con una sola richiesta.

- **REST semplice, senza SDK** — Una sola POST autenticata invia una push dal client HTTP che già usi. Nessun SDK, coda o broker di mezzo.
- **Qualsiasi linguaggio** — Node, Python, PHP, Go e Ruby possono tutti inviare una notifica Pocket Alert.
- **Autenticazione con chiave** — La tua chiave API viaggia nell'header Token tramite HTTPS. Crea, limita e ruota le chiavi quando preferisci.
- **Controllo completo** — Indirizza con application_id e scegli un singolo device_id, oppure omettilo per raggiungere tutti i dispositivi, con una sola chiamata.
- **Consegna in meno di un secondo** — Le push arrivano su iPhone o Android in meno di un secondo, abbastanza rapide per alimentare avvisi real-time dal backend.
- **Pronto per CLI e webhook** — La stessa API alimenta la CLI e i webhook. Inizia con il codice e aggiungi l'una o l'altra in seguito.

## Invia la tua prima notifica via API

### 1. Ottieni una chiave API

Crea una chiave nella pagina [Chiavi API](https://pocketalert.app/it/account/apikeys) e inviala nell'header `Token` in ogni richiesta.

### 2. Invia un messaggio con POST

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Order shipped","message":"Order #1024 is on its way","application_id":"qm47b9pzxzxg"}'
```

### 3. Dal tuo codice

Richiamala dovunque un endpoint restituisca un errore o si verifichi un evento personalizzato, ad esempio dopo un health check fallito o un nuovo ordine:

```
await fetch("https://api.pocketalert.app/v1/messages", {
  method: "POST",
  headers: { Token: process.env.POCKETALERT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "API health check failed",
    message: "GET /v1/orders returned 500",
    application_id: "qm47b9pzxzxg",
    level: "high",
  }),
});
```

La [guida introduttiva completa](https://info.pocketalert.app/getting-started.html) spiega come indirizzare applicazioni e dispositivi.

## FAQ

### Come invio una notifica tramite API?

Esegui una POST all'API dei messaggi di Pocket Alert con la tua chiave nell'header Token e un corpo JSON contenente title e message. La notifica arriva subito sul tuo telefono.

### Come funziona l'autenticazione API?

Autenticati con una chiave API dalla pagina Impostazioni, inviata nell'header Token tramite HTTPS. Crea e ruota le chiavi quando vuoi e limita gli avvisi per applicazione.

### Quali linguaggi sono supportati?

Funziona con qualsiasi linguaggio che possa fare una richiesta HTTP: Node, Python, PHP, Go, Ruby e Rust. Non serve installare nulla, basta una semplice chiamata REST dal client HTTP che già usi.

### Cosa posso controllare nella richiesta?

Imposta title e message, indirizza a un'applicazione specifica con application_id, scegli un singolo dispositivo con device_id (oppure omettilo per raggiungere tutti i dispositivi) e imposta la priorità con level, da silent a critical. Un messaggio critical supera Non disturbare su Android e attraversa la Full immersion su iPhone.

### Sono disponibili anche la CLI o i webhook?

Sì. La CLI di Pocket Alert incapsula la stessa API per script e CI. Se preferisci non scrivere codice, crea un webhook e indirizza un servizio al suo URL di ricezione.
