Exemples d'intégration Heartbeat

L'intégration du heartbeat est simple : un appel HTTP à la fin de votre script.

Voici des exemples dans différents langages pour vous aider à démarrer.

Les 3 endpoints disponibles

Chaque endpoint a un rôle spécifique :

Ping (succès)

Signale que la tâche s'est exécutée avec succès.

# Signal de succes (ping)
curl -X POST https://monitao.com/api/heartbeat/ping/YOUR_PING_TOKEN \
  -H "Authorization: Bearer YOUR_API_SECRET"

Start (début)

Signale le début de la tâche (optionnel, permet de mesurer la durée).

# Signal de debut (start)
curl -X POST https://monitao.com/api/heartbeat/start/YOUR_PING_TOKEN \
  -H "Authorization: Bearer YOUR_API_SECRET"

Fail (échec)

Signale un échec explicite de la tâche.

# Signal d'echec (fail)
curl -X POST https://monitao.com/api/heartbeat/fail/YOUR_PING_TOKEN \
  -H "Authorization: Bearer YOUR_API_SECRET"

Exemples d'intégration

Script Bash

#!/bin/bash
# Script avec heartbeat MoniTao

TOKEN="YOUR_PING_TOKEN"
SECRET="YOUR_API_SECRET"
URL="https://monitao.com/api/heartbeat"

# Signal debut
curl -s -X POST "$URL/start/$TOKEN" -H "Authorization: Bearer $SECRET"

# Votre tache ici
./my_task.sh

# Verifier le code de sortie
if [ $? -eq 0 ]; then
    curl -s -X POST "$URL/ping/$TOKEN" -H "Authorization: Bearer $SECRET"
else
    curl -s -X POST "$URL/fail/$TOKEN" -H "Authorization: Bearer $SECRET"
fi

Script PHP

<?php
// PHP avec heartbeat MoniTao

$token = 'YOUR_PING_TOKEN';
$secret = 'YOUR_API_SECRET';
$baseUrl = 'https://monitao.com/api/heartbeat';

function sendHeartbeat($endpoint, $token, $secret) {
    $ch = curl_init("https://monitao.com/api/heartbeat/$endpoint/$token");
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $secret"]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $result = curl_exec($ch);
    curl_close($ch);
    return $result;
}

// Utilisation
sendHeartbeat('start', $token, $secret);

try {
    // Votre code ici
    processData();
    sendHeartbeat('ping', $token, $secret);
} catch (Exception $e) {
    sendHeartbeat('fail', $token, $secret);
    throw $e;
}

Script Python

import requests

TOKEN = "YOUR_PING_TOKEN"
SECRET = "YOUR_API_SECRET"
BASE_URL = "https://monitao.com/api/heartbeat"

def heartbeat(endpoint):
    return requests.post(
        f"{BASE_URL}/{endpoint}/{TOKEN}",
        headers={"Authorization": f"Bearer {SECRET}"}
    )

# Utilisation
heartbeat("start")

try:
    # Votre code ici
    process_data()
    heartbeat("ping")
except Exception as e:
    heartbeat("fail")
    raise e

Questions fréquentes