Connexion





Mot de passe oublié ?

monitor.contact.bind

Attache un contact à un moniteur. Les contacts peuvent recevoir des alertes quand le serveur checké est indisponible ou ne répond pas comme prévu.

Authentification & Action

Cette méthode nécessite une authentification. Elle peut être accessible par http et https.

Action type: HTTP POST.

Arguments

monitor_id (requis, voir note 1)

L'id d'un moniteur existant. Doit être un entier.

monitor_name (requis, voir note 1)

Le nom d'un moniteur existant. Doit être une chaine (string) de 64 caractères maximum.

contact_id (requis, voir note 2)

l'id d'un contact existant. Doit être un entier.

contact_name (requis, voir note 2)

Le nom d'un contact existant. Doit être une chaine de 64 caractères maximum.

delay (non requis)

Le délai avant qu'une alerte soit envoyée. 0=immédiatement après qu'une erreur ait été trouvé, 1 = après 1 check, 2 = après 2 checks etc... Si la fréquence du moniteur est 2 minutes, paramétrer le délai à 3 enverra une alerte si le serveur est en erreur après 3 checks (donc après 6 minutes). Doit être un entier. Défaut = 0

alert_type (non requis)

Il y a 2 types d'alertes. 'a' = alerte en erreur, 'r' = alerte en erreur ET quand le serveur est de nouveau disponible.  Valeurs autorisée: a = en erreur seulement / r = en erreur et de nouveau disponible.  Défaut: a

 

NOTE 1: Il est possible d'utiliser les deux monitor_id et monitor_name comme une clé. Si les deux sont présents, le monitor_id est considéré comme la clé.

 

NOTE 2: Il est possible d'utiliser les deux contact_id et contact_name comme une clé. Si les deux sont présents, le contact_id est considéré comme la clé.

Exemple: Demande

http://api.webcron.org/monitor.contact.bind
contact_id=1983&monitor_id=52319&delay=2&alert_type=r

Exemple: Réponse

<rsp status="ok">
   <bind contact_id="1983" monitor_id="52319" />
</rsp>