UptimePoint API

Version 1.0.0

OpenAPI JSON

Authentification

Toutes les requêtes API nécessitent une clé API passée dans le header Authorization.

Authorization: Bearer awm_votre_cle_api

Générez vos clés depuis le dashboard → Paramètres → API Keys.

🌐Sites 📊Checks 🔔Alertes 📋Status Pages 🔧Maintenance 📄Rapports ❤️Heartbeats ⚠️Incidents

🌐 Sites

GET/api/v1/sitesAPI Key

Retourne tous les sites de votre organisation avec pagination.

Voir l'exemple cURL ▼

curl -H "Authorization: Bearer awm_votre_cle_api" \
  "https://uptimepoint.com/api/v1/sites?limit=10&offset=0"

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/sitesAPI Key

Crée un nouveau site à surveiller.

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mon Site","url":"https://example.com","monitorSsl":true}' \
  "https://uptimepoint.com/api/v1/sites"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/sites/{id}API Key

Retourne les informations détaillées d'un site.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/sites/{id}API Key

Met à jour la configuration d'un site.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/sites/{id}API Key

Supprime définitivement un site et ses données.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/sites/{id}/checksAPI Key

Historique des résultats de checks pour un site.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/sites/{id}/checksAPI Key

Déclenche un check immédiat sur tous les types activés.

Réponse : { data: ..., meta: { total, limit, offset } }

📊 Checks

GET/api/v1/checksAPI Key

Liste paginée des résultats de checks. Filtrable par siteId et type.

Voir l'exemple cURL ▼

curl -H "Authorization: Bearer awm_votre_cle_api" \
  "https://uptimepoint.com/api/v1/checks?type=SSL&limit=5"

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/checks/{id}API Key

Retourne les détails d'un résultat de check.

Réponse : { data: ..., meta: { total, limit, offset } }

🔔 Alertes

GET/api/v1/alertsAPI Key

Toutes les configurations d'alertes de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/alertsAPI Key

Crée une nouvelle configuration d'alerte (email requis).

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com","uptimeDown":true,"slackWebhookUrl":"https://hooks.slack.com/..."}' \
  "https://uptimepoint.com/api/v1/alerts"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/alerts/{id}API Key

Alerte avec ses 20 derniers événements.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/alerts/{id}API Key

Met à jour une configuration d'alerte.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/alerts/{id}API Key

Supprime une configuration d'alerte.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/alerts/eventsAPI Key

Historique de tous les événements d'alertes envoyés.

Réponse : { data: ..., meta: { total, limit, offset } }

📋 Status Pages

GET/api/v1/status-pagesAPI Key

Toutes les status pages de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/status-pagesAPI Key

Crée une nouvelle page de statut public.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/status-pages/{id}API Key

Status page avec ses abonnés.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/status-pages/{id}API Key

Met à jour une status page (inclut password, incidents, etc.).

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/status-pages/{id}API Key

Supprime définitivement une status page.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/status-pages/{id}/subscribersAPI Key

Liste des abonnés email d'une status page.

Réponse : { data: ..., meta: { total, limit, offset } }

🔧 Maintenance

GET/api/v1/maintenance-windowsAPI Key

Toutes les fenêtres de maintenance planifiées.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/maintenance-windowsAPI Key

Crée une nouvelle fenêtre de maintenance (title, startsAt, endsAt, siteIds requis).

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"title":"Mise à jour serveur","startsAt":"2026-06-15T02:00:00Z","endsAt":"2026-06-15T04:00:00Z","siteIds":["site_id_1","site_id_2"]}' \
  "https://uptimepoint.com/api/v1/maintenance-windows"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/maintenance-windows/{id}API Key

Retourne les informations d'une fenêtre de maintenance.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/maintenance-windows/{id}API Key

Met à jour les champs d'une fenêtre de maintenance.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/maintenance-windows/{id}API Key

Supprime définitivement une fenêtre de maintenance.

Réponse : { data: ..., meta: { total, limit, offset } }

📄 Rapports

GET/api/v1/reportsAPI Key

Tous les rapports clients (plan SOLO+ requis).

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/reportsAPI Key

Crée un nouveau rapport client PDF.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/reports/{id}API Key

Retourne les informations d'un rapport.

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/reports/{id}API Key

Supprime un rapport.

Réponse : { data: ..., meta: { total, limit, offset } }

❤️ Heartbeats

GET/api/v1/heartbeatsAPI Key

Tous les heartbeats de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/heartbeatsAPI Key

Crée un nouveau heartbeat avec un nom et une période de grâce.

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mon Script","gracePeriod":300,"interval":300}' \
  "https://uptimepoint.com/api/v1/heartbeats"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/heartbeats/{id}API Key

Retourne les informations détaillées d'un heartbeat.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/heartbeats/{id}API Key

Met à jour la configuration d'un heartbeat.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/heartbeats/{id}API Key

Supprime définitivement un heartbeat.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/heartbeats/{id}/pingsAPI Key

Historique des signaux reçus par un heartbeat.

Réponse : { data: ..., meta: { total, limit, offset } }

Envoyer un signal

Les endpoints /api/heartbeat/:token ne nécessitent pas de clé API. Incluez l'URL générée dans vos scripts pour envoyer des signaux.

curl -X POST "https://uptimepoint.com/api/heartbeat/TOKEN?signal=start&duration=1500"

📄 Incidents

GET/api/v1/incidentsAPI Key

Tous les incidents de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/incidentsAPI Key

Crée un nouvel incident (manuel ou auto).

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"title":"Panne API","impact":"major","siteIds":["site_id"],"statusPageIds":["page_id"]}' \
  "https://uptimepoint.com/api/v1/incidents"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/incidents/{id}API Key

Retourne l'incident avec ses mises à jour.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/incidents/{id}API Key

Met à jour le statut, titre, ou cause d'un incident.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/incidents/{id}API Key

Supprime un incident et ses mises à jour.

Réponse : { data: ..., meta: { total, limit, offset } }

Alias

Les endpoints /api/v1/monitors, /api/v1/monitors/{id} et /api/v1/monitors/{id}/checks sont des alias exacts de /api/v1/sites.

Pagination

Les endpoints GET acceptent les paramètres limit (max 100, défaut 50) et offset (défaut 0).

GET /api/v1/sites?limit=10&offset=20

Codes d'erreur

401Clé API manquante ou invalide

403Feature non disponible sur votre plan

404Ressource non trouvée

400Requête invalide (champs requis manquants)

409Conflit (slug déjà utilisé, etc.)

500Erreur interne du serveur

UptimePoint API

Version 1.0.0

OpenAPI JSON

Authentification

Toutes les requêtes API nécessitent une clé API passée dans le header Authorization.

Authorization: Bearer awm_votre_cle_api

Générez vos clés depuis le dashboard → Paramètres → API Keys.

🌐Sites 📊Checks 🔔Alertes 📋Status Pages 🔧Maintenance 📄Rapports ❤️Heartbeats ⚠️Incidents

🌐 Sites

GET/api/v1/sitesAPI Key

Retourne tous les sites de votre organisation avec pagination.

Voir l'exemple cURL ▼

curl -H "Authorization: Bearer awm_votre_cle_api" \
  "https://uptimepoint.com/api/v1/sites?limit=10&offset=0"

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/sitesAPI Key

Crée un nouveau site à surveiller.

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mon Site","url":"https://example.com","monitorSsl":true}' \
  "https://uptimepoint.com/api/v1/sites"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/sites/{id}API Key

Retourne les informations détaillées d'un site.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/sites/{id}API Key

Met à jour la configuration d'un site.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/sites/{id}API Key

Supprime définitivement un site et ses données.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/sites/{id}/checksAPI Key

Historique des résultats de checks pour un site.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/sites/{id}/checksAPI Key

Déclenche un check immédiat sur tous les types activés.

Réponse : { data: ..., meta: { total, limit, offset } }

📊 Checks

GET/api/v1/checksAPI Key

Liste paginée des résultats de checks. Filtrable par siteId et type.

Voir l'exemple cURL ▼

curl -H "Authorization: Bearer awm_votre_cle_api" \
  "https://uptimepoint.com/api/v1/checks?type=SSL&limit=5"

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/checks/{id}API Key

Retourne les détails d'un résultat de check.

Réponse : { data: ..., meta: { total, limit, offset } }

🔔 Alertes

GET/api/v1/alertsAPI Key

Toutes les configurations d'alertes de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/alertsAPI Key

Crée une nouvelle configuration d'alerte (email requis).

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com","uptimeDown":true,"slackWebhookUrl":"https://hooks.slack.com/..."}' \
  "https://uptimepoint.com/api/v1/alerts"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/alerts/{id}API Key

Alerte avec ses 20 derniers événements.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/alerts/{id}API Key

Met à jour une configuration d'alerte.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/alerts/{id}API Key

Supprime une configuration d'alerte.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/alerts/eventsAPI Key

Historique de tous les événements d'alertes envoyés.

Réponse : { data: ..., meta: { total, limit, offset } }

📋 Status Pages

GET/api/v1/status-pagesAPI Key

Toutes les status pages de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/status-pagesAPI Key

Crée une nouvelle page de statut public.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/status-pages/{id}API Key

Status page avec ses abonnés.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/status-pages/{id}API Key

Met à jour une status page (inclut password, incidents, etc.).

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/status-pages/{id}API Key

Supprime définitivement une status page.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/status-pages/{id}/subscribersAPI Key

Liste des abonnés email d'une status page.

Réponse : { data: ..., meta: { total, limit, offset } }

🔧 Maintenance

GET/api/v1/maintenance-windowsAPI Key

Toutes les fenêtres de maintenance planifiées.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/maintenance-windowsAPI Key

Crée une nouvelle fenêtre de maintenance (title, startsAt, endsAt, siteIds requis).

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"title":"Mise à jour serveur","startsAt":"2026-06-15T02:00:00Z","endsAt":"2026-06-15T04:00:00Z","siteIds":["site_id_1","site_id_2"]}' \
  "https://uptimepoint.com/api/v1/maintenance-windows"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/maintenance-windows/{id}API Key

Retourne les informations d'une fenêtre de maintenance.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/maintenance-windows/{id}API Key

Met à jour les champs d'une fenêtre de maintenance.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/maintenance-windows/{id}API Key

Supprime définitivement une fenêtre de maintenance.

Réponse : { data: ..., meta: { total, limit, offset } }

📄 Rapports

GET/api/v1/reportsAPI Key

Tous les rapports clients (plan SOLO+ requis).

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/reportsAPI Key

Crée un nouveau rapport client PDF.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/reports/{id}API Key

Retourne les informations d'un rapport.

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/reports/{id}API Key

Supprime un rapport.

Réponse : { data: ..., meta: { total, limit, offset } }

❤️ Heartbeats

GET/api/v1/heartbeatsAPI Key

Tous les heartbeats de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/heartbeatsAPI Key

Crée un nouveau heartbeat avec un nom et une période de grâce.

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mon Script","gracePeriod":300,"interval":300}' \
  "https://uptimepoint.com/api/v1/heartbeats"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/heartbeats/{id}API Key

Retourne les informations détaillées d'un heartbeat.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/heartbeats/{id}API Key

Met à jour la configuration d'un heartbeat.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/heartbeats/{id}API Key

Supprime définitivement un heartbeat.

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/heartbeats/{id}/pingsAPI Key

Historique des signaux reçus par un heartbeat.

Réponse : { data: ..., meta: { total, limit, offset } }

Envoyer un signal

Les endpoints /api/heartbeat/:token ne nécessitent pas de clé API. Incluez l'URL générée dans vos scripts pour envoyer des signaux.

curl -X POST "https://uptimepoint.com/api/heartbeat/TOKEN?signal=start&duration=1500"

📄 Incidents

GET/api/v1/incidentsAPI Key

Tous les incidents de votre organisation.

Réponse : { data: ..., meta: { total, limit, offset } }

POST/api/v1/incidentsAPI Key

Crée un nouvel incident (manuel ou auto).

Voir l'exemple cURL ▼

curl -X POST -H "Authorization: Bearer awm_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"title":"Panne API","impact":"major","siteIds":["site_id"],"statusPageIds":["page_id"]}' \
  "https://uptimepoint.com/api/v1/incidents"

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

GET/api/v1/incidents/{id}API Key

Retourne l'incident avec ses mises à jour.

Réponse : { data: ..., meta: { total, limit, offset } }

PUT/api/v1/incidents/{id}API Key

Met à jour le statut, titre, ou cause d'un incident.

Body : JSON avec les champs à modifier (voir OpenAPI spec pour la liste complète)

Réponse : { data: ..., meta: { total, limit, offset } }

DELETE/api/v1/incidents/{id}API Key

Supprime un incident et ses mises à jour.

Réponse : { data: ..., meta: { total, limit, offset } }

Alias

Les endpoints /api/v1/monitors, /api/v1/monitors/{id} et /api/v1/monitors/{id}/checks sont des alias exacts de /api/v1/sites.

Pagination

Les endpoints GET acceptent les paramètres limit (max 100, défaut 50) et offset (défaut 0).

GET /api/v1/sites?limit=10&offset=20

Codes d'erreur

401Clé API manquante ou invalide

403Feature non disponible sur votre plan

404Ressource non trouvée

400Requête invalide (champs requis manquants)

409Conflit (slug déjà utilisé, etc.)

500Erreur interne du serveur