Documentation de l'API

L'API REST de FastPing vous permet de gérer les moniteurs et de lire les résultats. Elle est incluse dans l'option Accès API. Créez des clés dans la section Clés API du tableau de bord.

Authentification

Envoyez votre clé en tant que jeton bearer. Toutes les réponses sont au format JSON. Limite : 120 requêtes par minute et par clé.

curl -H "Authorization: Bearer fp_xxxxxxxx" https://fastping.app/api/v1/monitors

GET /api/v1/monitors

Lister tous les moniteurs avec leur statut actuel et leur disponibilité sur 24 heures.

GET /api/v1/monitors/:id

Un moniteur avec sa disponibilité sur 1, 7, 30 et 90 jours, ses 100 dernières vérifications et ses 20 derniers incidents.

POST /api/v1/monitors

Créer un moniteur. Champs : type, name, url (types web) ou host, port, interval (secondes), options.

curl -X POST https://fastping.app/api/v1/monitors \
  -H "Authorization: Bearer fp_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"type":"http","name":"Shop","url":"https://shop.example.com","interval":60}'

POST /api/v1/monitors/:id/pause · /resume

Mettre en pause ou reprendre les vérifications.

DELETE /api/v1/monitors/:id

Supprimer un moniteur et son historique.

Types de moniteurs

http, keyword, api, ping, tcp, dns, ssl, domain, email, blacklist, game, heartbeat, security

Alertes webhook

Les canaux webhook reçoivent un POST avec ce corps JSON :

{
  "event": "down",            // down | up | warn | event
  "monitor": { "id": 12, "name": "Shop", "type": "http", "target": "https://shop.example.com" },
  "detail": "HTTP 503",
  "status": "down",
  "timestamp": "2026-10-17T09:30:00.000Z",
  "url": "https://fastping.app/app/monitors/12"
}

Heartbeats

Les moniteurs heartbeat reçoivent une URL unique. Appelez-la avec GET, POST ou HEAD :

curl -fsS https://fastping.app/hb/<token>