Dokumentacija

Pridobi monitor

GET /api/v1/monitors/{id}

En monitor, po id iz seznama monitorjev. Monitor druge ekipe ali monitor na izbrisani tarči vrne 404.

Primer

cURL

curl http://pulsekeeper.io/api/v1/monitors/a81c27e05f3d9b64 \
  -H "Authorization: Bearer $PULSEKEEPER_TOKEN"

PHP

<?php

// composer require guzzlehttp/guzzle
$client = new GuzzleHttp\Client([
    'base_uri' => 'http://pulsekeeper.io/api/v1/',
    'headers' => ['Authorization' => 'Bearer '.getenv('PULSEKEEPER_TOKEN')],
]);

$monitor = json_decode($client->get('monitors/a81c27e05f3d9b64')->getBody(), true)['data'];

JavaScript

const response = await fetch('http://pulsekeeper.io/api/v1/monitors/a81c27e05f3d9b64', {
  headers: { Authorization: `Bearer ${process.env.PULSEKEEPER_TOKEN}` },
});

const { data: monitor } = await response.json();

Go

req, _ := http.NewRequest("GET", "http://pulsekeeper.io/api/v1/monitors/a81c27e05f3d9b64", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("PULSEKEEPER_TOKEN"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()

var body struct {
	Data map[string]any `json:"data"`
}
json.NewDecoder(res.Body).Decode(&body)

Odgovor

{
  "data": {
    "id": "a81c27e05f3d9b64",
    "type": "http",
    "name": "HTTP",
    "target": "shop.example.com",
    "client": { "id": "c4e0b9a17d2f6385", "name": "Example Shop" },
    "state": "ok",
    "paused": false,
    "first_ok_at": "2026-08-02T09:10:00Z",
    "created_at": "2026-08-02T09:08:44Z"
  }
}

Polja

Polje Pomen
type http, api, port, ping ali heartbeat. Glejte vrste monitorjev.
name Oznaka monitorja v aplikaciji: HTTP, TCP 5432, GET /health ali ime, ki ste ga dali heartbeatu.
target Ime gostitelja ali naslov IP; null pri heartbeatih.
client Stranka, ki ji tarča pripada; null pri heartbeatih.
state Trenutno stanje: ok, investigating (sum, ki ga preverjamo z drugih lokacij, ne izpad), down, degraded, never_connected (se še nikoli ni odzval, običajno tipkarska napaka ali požarni zid) ali unknown.
paused true, kadar je pavziran monitor ali celotna tarča. Pavziran monitor se ne preverja.
first_ok_at Prvo uspešno preverjanje. Razpoložljivost se šteje od tu; null, če se nikoli ni odzval.