API pour développeurs

Envoyez une notification push depuis votre backend.

L’API Pocket Alert envoie une notification push sur votre téléphone avec une seule requête POST authentifiée. Déclenchez-la depuis Node, Python, PHP ou Go, avec le title, le message et le niveau de priorité, et elle atteint votre iPhone ou votre Android presque instantanément.

Push en <1sREST simpleNode · Python · Go · PHPMis à jour le
Fonctionnalités

Des notifications à une seule requête

L’API alimente chaque alerte Pocket Alert. Intégrez-la à votre backend avec une seule requête.

REST simple, sans SDK

Un seul POST authentifié envoie une notification push depuis le client HTTP que vous utilisez déjà. Ni SDK, ni file d’attente, ni broker.

Tous les langages

Node, Python, PHP, Go et Ruby peuvent tous déclencher une notification Pocket Alert.

Authentification par clé

Votre clé API est transmise dans l’en-tête Token via HTTPS. Créez, limitez et renouvelez vos clés à votre rythme.

Contrôle total

Routez avec application_id et ciblez un seul device_id, ou omettez-le pour atteindre tous les appareils, en un seul appel.

Livraison en moins d’une seconde

Les notifications push arrivent sur votre iPhone ou votre Android en moins d’une seconde, assez rapidement pour piloter des alertes backend en temps réel.

CLI et webhook prêts

La même API alimente la CLI et les webhooks. Commencez par le code et ajoutez l’un ou l’autre plus tard.

Pour commencer

Trois étapes pour votre première notification push via API

1

Obtenez une clé API

Créez une clé API sur la page Clés API et conservez-la dans une variable d’environnement.

2

Envoyez une requête

Envoyez en POST un title et un message au format JSON vers le point de terminaison des messages, avec la clé dans l’en-tête Token.

3

Mettez-la en production

Votre téléphone vibre en moins d’une seconde. Ajoutez le ciblage par application et par appareil à mesure que vos besoins évoluent.

Envoyez votre première notification API

1. Obtenez une clé API

Créez une clé sur la page Clés API et transmettez-la dans l’en-tête Token à chaque requête.

2. Envoyez un message avec 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. Depuis votre code

Appelez-la depuis l’endroit où un point de terminaison renvoie une erreur ou où un événement personnalisé se déclenche, par exemple après un échec de contrôle de santé ou une nouvelle commande :

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 documentation de démarrage complète détaille le ciblage des applications et des appareils.

FAQ

Vos questions, nos réponses

Faites un POST vers l’API de messages de Pocket Alert, avec votre clé dans l’en-tête Token et un corps JSON contenant le title et le message. La notification arrive immédiatement sur votre téléphone.

Authentifiez-vous avec une clé API générée sur la page Paramètres, transmise dans l’en-tête Token via HTTPS. Créez et renouvelez vos clés quand vous le souhaitez, et limitez les alertes par application.

Tout langage capable d’effectuer une requête HTTP convient : Node, Python, PHP, Go, Ruby et Rust. Rien à installer, il suffit d’un appel REST simple depuis le client HTTP que vous utilisez déjà.

Définissez le title et le message, routez vers une application précise avec application_id, ciblez un appareil avec device_id (ou omettez-le pour atteindre tous les appareils), et réglez la priorité avec level, de silencieux à critique. Un message critique passe outre le mode Ne pas déranger sur Android et la Concentration sur iPhone.

Oui. La CLI Pocket Alert encapsule la même API pour les scripts et la CI. Si vous préférez ne pas écrire de code, créez un webhook et pointez un service vers son URL de réception.

Une seule requête, directement sur votre téléphone.

Créez une clé API et envoyez votre première notification depuis votre backend.