Developer Documentation

curl -H "Authorization: Bearer vtk_your_token_here" \
     https://vigilmon.online/api/v1/monitors

https://vigilmon.online/api/v1

TOKEN="vtk_your_token"
MONITOR_ID=1

# Pause before deploy
curl -X PATCH \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"is_active":false}' \
     https://vigilmon.online/api/v1/monitors/$MONITOR_ID

# ... run your deployment ...

# Resume after deploy
curl -X PATCH \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"is_active":true}' \
     https://vigilmon.online/api/v1/monitors/$MONITOR_ID

{
  "event": "monitor_down",
  "monitor": {
    "id": 1,
    "name": "Production API",
    "url": "https://api.example.com/health"
  },
  "status": "down",
  "checked_at": "2024-01-15T08:12:00+00:00",
  "region": "za-vps",
  "response_time_ms": null,
  "error": null
}

{
  "event": "monitor_up",
  "monitor": {
    "id": 1,
    "name": "Production API",
    "url": "https://api.example.com/health"
  },
  "status": "up",
  "checked_at": "2024-01-15T08:34:00+00:00",
  "region": "za-vps",
  "response_time_ms": null,
  "error": null
}

{
  "event": "monitor_escalation",
  "monitor": {
    "id": 1,
    "name": "Production API",
    "url": "https://api.example.com/health"
  },
  "status": "down",
  "down_minutes": 30,
  "incident_started_at": "2024-01-15T08:12:00+00:00",
  "region": "za-vps"
}

{
  "event": "ssl.expiring",
  "monitor_url": "https://api.example.com",
  "days_remaining": 14,
  "threshold": 30,
  "expires_at": "2024-01-29T23:59:59+00:00"
}

// Example: verify the secret in Node.js
app.post('/webhook', (req, res) => {
  const secret = req.headers['x-vigilmon-secret'];
  if (secret !== process.env.VIGILMON_SECRET) {
    return res.status(401).json({ error: 'Unauthorized' });
  }
  // handle payload
  res.sendStatus(200);
});

// npm install express
const express = require('express');
const app = express();
app.use(express.json());

const VIGILMON_SECRET = process.env.VIGILMON_SECRET; // optional

app.post('/vigilmon', (req, res) => {
  // Verify secret if configured
  if (VIGILMON_SECRET && req.headers['x-vigilmon-secret'] !== VIGILMON_SECRET) {
    return res.status(401).json({ error: 'Unauthorized' });
  }

  const { event, monitor } = req.body;

  switch (event) {
    case 'monitor_down':
      console.log(`DOWN: ${monitor.name} (${monitor.url})`);
      // page on-call, update status page, etc.
      break;
    case 'monitor_up':
      console.log(`RECOVERED: ${monitor.name} is back up`);
      break;
    case 'monitor_escalation':
      console.log(`ESCALATION: ${monitor.name} down ${req.body.down_minutes} min`);
      break;
    case 'ssl.expiring':
      console.log(`SSL: ${req.body.monitor_url} expires in ${req.body.days_remaining} days`);
      break;
  }

  res.sendStatus(200); // respond 2xx to acknowledge
});

app.listen(3000, () => console.log('Listening on :3000'));

# pip install flask
import os
from flask import Flask, request, abort

app = Flask(__name__)
VIGILMON_SECRET = os.getenv('VIGILMON_SECRET')

@app.route('/vigilmon', methods=['POST'])
def vigilmon_webhook():
    # Verify secret if configured
    if VIGILMON_SECRET:
        if request.headers.get('X-Vigilmon-Secret') != VIGILMON_SECRET:
            abort(401)

    data = request.get_json()
    event = data.get('event')
    monitor = data.get('monitor', {})

    if event == 'monitor_down':
        print(f"DOWN: {monitor.get('name')} ({monitor.get('url')})")
        # your alerting logic here
    elif event == 'monitor_up':
        print(f"RECOVERED: {monitor.get('name')} is back up")
    elif event == 'monitor_escalation':
        print(f"ESCALATION: {monitor.get('name')} down {data.get('down_minutes')} min")
    elif event == 'ssl.expiring':
        print(f"SSL: {data.get('monitor_url')} expires in {data.get('days_remaining')} days")

    return '', 200

if __name__ == '__main__':
    app.run(port=3000)

// routes/web.php or routes/api.php
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;

Route::post('/webhooks/vigilmon', function (Request $request) {
    // Verify secret if configured
    $secret = config('services.vigilmon.webhook_secret');
    if ($secret && $request->header('X-Vigilmon-Secret') !== $secret) {
        abort(401);
    }

    $event   = $request->input('event');
    $monitor = $request->input('monitor', []);

    match ($event) {
        'monitor_down' => Log::alert('Monitor down', [
            'name' => $monitor['name'],
            'url'  => $monitor['url'],
            'at'   => $request->input('checked_at'),
        ]),
        'monitor_up' => Log::info('Monitor recovered', [
            'name' => $monitor['name'],
        ]),
        'monitor_escalation' => Log::critical('Monitor escalation', [
            'name'         => $monitor['name'],
            'down_minutes' => $request->input('down_minutes'),
        ]),
        'ssl.expiring' => Log::warning('SSL certificate expiring', [
            'url'           => $request->input('monitor_url'),
            'days_remaining' => $request->input('days_remaining'),
        ]),
        default => null,
    };

    return response()->noContent(); // 204 — Vigilmon treats any 2xx as success
})->withoutMiddleware([\App\Http\Middleware\VerifyCsrfToken::class]);