# Envía una notificación push desde tu backend.

> Envía notificaciones push desde tu backend con la API de Pocket Alert. Un solo HTTP POST autenticado desde Node, Python, PHP o Go llega a tu teléfono en un segundo.

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

Última actualización: 2026-08-11

La API de Pocket Alert envía una notificación push a tu teléfono con una sola solicitud POST autenticada por HTTP. Lánzala desde Node, Python, PHP o Go, con title, message y nivel de prioridad, y llegará a tu iPhone o Android casi al instante.

## Tres pasos para tu primera push por API

1. **Obtén una clave de API** — Crea una clave de API en la página Claves de API y guárdala en una variable de entorno.
2. **Envía una solicitud** — Envía un title y un message en JSON al endpoint de mensajes con la clave en el encabezado Token.
3. **Ponlo en marcha** — Tu teléfono vibra en menos de un segundo. Añade la segmentación por aplicación y dispositivo a medida que la necesites.

## Notificaciones, a una solicitud de distancia

La API impulsa cada alerta de Pocket Alert. Intégrala en tu backend con una sola solicitud.

- **REST simple, sin SDK** — Un solo POST autenticado envía una push desde el cliente HTTP que ya usas. No intervienen SDK, colas ni brokers.
- **Cualquier lenguaje** — Node, Python, PHP, Go y Ruby pueden enviar una notificación de Pocket Alert.
- **Autenticación por clave** — Tu clave de API viaja en el encabezado Token por HTTPS. Crea, limita y rota las claves según tu propio calendario.
- **Control total** — Envía a una aplicación con application_id y apunta a un único device_id, o omítelo para llegar a todos los dispositivos, todo en una sola llamada.
- **Entrega en menos de un segundo** — Las notificaciones push llegan a tu iPhone o Android en menos de un segundo, lo bastante rápido para alertas en tiempo real desde tu backend.
- **Listo para CLI y webhooks** — La misma API alimenta la CLI y los webhooks. Empieza con código y añade cualquiera de los dos más adelante.

## Envía tu primera notificación por API

### 1. Obtén una clave de API

Crea una clave en la página de [Claves de API](https://pocketalert.app/es/account/apikeys) y envíala en el encabezado `Token` en cada solicitud.

### 2. Envía un mensaje 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. Desde tu código

Llámala desde cualquier punto donde un endpoint falle o se dispare un evento personalizado, por ejemplo tras una comprobación de estado fallida o un pedido nuevo:

```
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 [documentación de primeros pasos](https://info.pocketalert.app/getting-started.html) completa explica cómo segmentar por aplicación y dispositivo.

## Preguntas frecuentes

### ¿Cómo envío una notificación por API?

Haz un POST a la API de mensajes de Pocket Alert con tu clave en el encabezado Token y un cuerpo JSON con el title y el message. La notificación llega a tu teléfono al instante.

### ¿Cómo funciona la autenticación por API?

Autentícate con una clave de API de la página de configuración, enviada en el encabezado Token por HTTPS. Crea y rota las claves cuando lo necesites, y limita las alertas por aplicación.

### ¿Qué lenguajes son compatibles?

Funciona cualquier lenguaje que haga una solicitud HTTP: Node, Python, PHP, Go, Ruby y Rust. No hay nada que instalar, solo una llamada REST sencilla desde el cliente HTTP que ya usas.

### ¿Qué puedo controlar en la solicitud?

Define el title y el message, envía a una aplicación concreta con application_id, apunta a un dispositivo con device_id (o omítelo para llegar a todos los dispositivos) y define la prioridad con level, de silencioso a crítico. Un mensaje crítico salta el modo No molestar en Android y atraviesa el modo Concentración en iPhone.

### ¿También hay opción de CLI o webhook?

Sí. La CLI de Pocket Alert envuelve la misma API para scripts y CI. Si prefieres no escribir código, crea un webhook y apunta un servicio a su URL de recepción.
