İçeriğe geç
Centoculus

Uptime monitoring API

Uygulamada yaptığınız her şeyi REST API üzerinden de yapabilirsiniz: dağıtım hattınızdan monitör oluşturun, uptime ve yanıt sürelerini kendi panolarınıza çekin, durum sayfalarını ve uyarı kanallarını senkron tutun. Girdi JSON, çıktı JSON, tek bir Bearer token. API tokenları Business planı ve üzerinde sunulur.

Başlarken

Temel URL

https://app.centoculus.com/api/v1

Her istek iki başlık taşır: Authorization: Bearer <token> ve Accept: application/json. Gövdeli istekler JSON ve Content-Type: application/json ile gönderilir.

  1. Web uygulamasında veya mobil uygulamada Hesabım → API tokenları bölümünden bir token oluşturun ve kapsamlarını seçin.
  2. Tokenı hemen kopyalayın; yalnızca bir kez gösterilir.
  3. GET /me çağrısını yapın. Her tokenla çalışır ve tokenın kime ait olduğunu söyler.

İlk çağrınız:

curl https://app.centoculus.com/api/v1/me \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json"

Yanıt; rolü, dili ve tokenın eriştiği çalışma alanlarıyla birlikte kullanıcınızdır (kısaltılmış):

{
  "data": {
    "id": 4821,
    "name": "Mara Lindqvist",
    "email": "mara@example.com",
    "role": "customer_admin",
    "role_label": "admin",
    "locale": "en",
    "timezone": "Europe/Stockholm",
    "customers": [{"id": 1207, "name": "Example Ltd"}],
    "default_customer_id": 1207
  }
}

Tokenlar ve kapsamlar

Bir tokenın adı, isteğe bağlı bir son kullanma tarihi (en fazla 730 gün) ve kullanabileceği kapsamlar vardır. Yalnızca bir entegrasyonun ihtiyaç duyduğu kapsamları seçin: bir pano monitors:read ve incidents:read alır, bir dağıtım betiği monitors:write alır. Business planının altındaki planlarda bölüm görünür ama devre dışıdır.

Kapsamİzin verdiği
monitors:readMonitörleri listeleme ve görüntüleme, uptime, günlük uptime, yanıt süreleri, kontrol türleri, konumlar, pano özeti
monitors:writeMonitör oluşturma, güncelleme, silme, duraklatma ve sürdürme
servers:readSunucuları ve metriklerini listeleme ve görüntüleme
servers:writeSunucu oluşturma, güncelleme, silme, duraklatma ve sürdürme; ajan için yeni kurulum komutu
incidents:readOlayları listeleme ve görüntüleme, pano özeti
status-pages:readDurum sayfalarını listeleme ve görüntüleme
status-pages:writeDurum sayfalarını ve duyurularını oluşturma, güncelleme ve silme
notifications:readBildirim kanallarını ve kanal türlerini listeleme ve görüntüleme
notifications:writeKanal (e-posta, Telegram, webhook, push) oluşturma, güncelleme ve silme, test gönderme

GET /me her tokenla çalışır. Faturalama, ekip, tokenlar, hesap güvenliği ve onarımlara (fixes) API tokenıyla erişilemez ve 403 döner; ilgili kapsam olmadan yapılan çağrı da aynı şekilde 403 döner.

Bir tokenı aynı yerden iptal edin; hemen çalışmaz hale gelir.

Kurallar

  • Yanıtlar JSON biçimindedir. Tek bir nesne data altında, bir liste ise links ve meta ile birlikte data altında gelir.
  • Monitörler ve sunucular UUID ile; olaylar, durum sayfaları ve bildirim kanalları sayısal bir id ile adreslenir.
  • Zamanlar UTC olarak ISO 8601 biçimindedir, örneğin 2026-11-15T08:30:00.000000Z.
  • Listeler page ve per_page sorgu parametreleriyle sayfalanır; meta içinde current_page, last_page, per_page ve total bulunur. Varsayılan sayfa boyutları: monitörler 15 (en fazla 200), olaylar 25 (en fazla 100), bildirim kanalları 50, sunucular 100, durum sayfaları 15.
  • Birden çok çalışma alanı olan hesaplar (partnerler ve bayiler) bir şey oluştururken customer_id gönderir ve listeleri onunla filtreleyebilir. Müşteri hesapları bunu göndermez.
  • Genel bir istek kotası yoktur. Birkaç uç nokta sınırlandırılmıştır, örneğin e-posta onayının yeniden gönderilmesi (dakikada 10); bunlar Retry-After ile 429 döner. Kontrol aralığınızdan daha sık sorgulamayın; canlı veri için bir webhook kanalı kullanın.

Hatalar

Hatalar message içeren JSON olarak döner. Doğrulama hataları, her alan için bir mesaj listesi içeren errors ekler.

DurumAnlamı
401Token eksik, geçersiz, süresi dolmuş veya iptal edilmiş.
402Ön ödemeli bakiye bittiği için izleme duraklatıldı (bayi müşterileri); bakiye yüklenince devam eder.
403Tokenda kapsam yok, uç nokta API tokenlarına kapalı veya planınız bu özelliği içermiyor.
404Bulunamadı ya da çalışma alanınızda değil.
409Çakışma, örneğin zaten onaylanmış bir e-posta adresini onaylamak.
422Doğrulama başarısız; errors alanına bakın. Bir plan sınırına ulaşıldığında upgrade, daha büyük bir planın açtığı özelliği belirtir.
429Sınırlandırılmış bir uç noktaya çok fazla istek; Retry-After saniye kadar bekleyin.

Bir doğrulama hatası:

HTTP/1.1 422 Unprocessable Content

{
  "message": "The target field is required. (and 1 more error)",
  "errors": {
    "target": ["The target field is required."],
    "interval_seconds": ["The interval must be at least 60 seconds on your plan."]
  }
}

Monitörler

Monitör tek bir kontroldür: bir web sitesi, bir SSL sertifikası, bir ping, bir TCP portu, bir DNS kaydı, bir cron heartbeat veya bir alan adının e-posta kurulumu. Türler: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types planınızın hangi türleri, aralıkları ve konumları içerdiğini ve her türün varsayılanlarını söyler.

Uç noktaNe yapar
GET /monitors Listeler; filtreler status, search, ids (virgülle ayrılmış), with_stats=1 uptime ve son yanıt süresini ekler
POST /monitors Oluşturur; kontroller arka planda başlar
GET /monitors/{id} Konumları ve açık olayıyla tek bir monitör
PATCH /monitors/{id} Günceller; tür değiştirilemez
DELETE /monitors/{id} Siler (204)
POST /monitors/{id}/pause Duraklatır; açık olay kapatılır
POST /monitors/{id}/resume Sürdürür
GET /check-types Türler, varsayılanlar ve planınızın sınırları
GET /locations Etkin kontrol konumları (code, name, country)

Oluştururken alanlar

AlanAçıklama
name Görünen ad, en fazla 255 karakter. Zorunlu.
type Yukarıdaki türlerden biri. Zorunlu, sonradan değiştirilemez.
target Türe göre URL, ana makine adı, IP adresi veya alan adı. heartbeat dışında zorunlu; heartbeat size bunun yerine bir ping URL verir.
interval_seconds Kontrol aralığı. Alt sınır planınıza bağlıdır; GET /check-types bunu limits.min_interval_seconds olarak döndürür.
locations Konum kodları, örneğin ["eu", "sg"]. Kaç tane seçebileceğiniz planınıza bağlıdır.
primary_location Kesintileri ilk onaylayan ana konum (Smart Verify).
confirm_locations Size uyarı gitmeden önce arızayı kaç konumun görmesi gerektiği (1–3). Büyük planlarda yapılandırılabilir.
confirm_checks Bir kesintiyi kaç ardışık başarısız kontrolün onayladığı (1–3). Büyük planlarda yapılandırılabilir.
options Türe göre. http için: method (GET, HEAD, POST), expected_status (örn. 200-399 veya 200,301), keyword_mode (present veya absent) ile keyword, timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Belirtilmeyen seçenekler GET /check-types içindeki varsayılanları alır.

Anahtar kelimeli bir web sitesi kontrolü oluşturun:

curl -X POST https://app.centoculus.com/api/v1/monitors \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Shop",
    "type": "http",
    "target": "https://shop.example.com",
    "interval_seconds": 60,
    "locations": ["eu", "sg"],
    "options": {"keyword": "Add to cart", "expected_status": "200-399"}
  }'

Yanıt (201) monitörün kendisidir. Konumlar onu devraldığı anda provisioning.state değeri synced olur, ilk kontrolden sonra status değeri pending durumundan up durumuna geçer:

{
  "data": {
    "id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
    "customer_id": 1207,
    "name": "Shop",
    "type": "http",
    "target": "https://shop.example.com",
    "interval_seconds": 60,
    "options": {
      "method": "GET",
      "expected_status": "200-399",
      "keyword": "Add to cart",
      "keyword_mode": "present",
      "timeout_seconds": 10,
      "check_ssl": true,
      "warn_days": 14,
      "crit_days": 3,
      "allow_self_signed": false
    },
    "location_codes": ["eu", "sg"],
    "primary_location": "eu",
    "smart_verify": true,
    "confirm_locations": 1,
    "confirm_checks": 1,
    "status": "pending",
    "is_paused": false,
    "provisioning": {"state": "pending"},
    "locations": [
      {"code": "eu", "role": "primary", "name": "Europe", "status": "pending", "last_response_ms": null, "last_checked_at": null},
      {"code": "sg", "role": "verify", "name": "Singapore", "status": "pending", "last_response_ms": null, "last_checked_at": null}
    ],
    "open_incident": null,
    "last_checked_at": null,
    "status_changed_at": null,
    "created_at": "2026-11-15T08:30:12.000000Z",
    "updated_at": "2026-11-15T08:30:12.000000Z"
  }
}

Durum değerleri: pending, up, degraded, down, paused.

Bir dağıtım sırasında monitörü duraklatın ve sonra sürdürün:

curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/pause \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"

curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/resume \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"

Uptime ve yanıt süreleri

Uptime, kesintilerden (önem derecesi major olan olaylar) hesaplanır; süresi dolmak üzere olan sertifika gibi uyarılar sayılmaz. Henüz kontrol edilmedi null demektir, 100 değil.

Uç noktaNe yapar
GET /monitors/{id}/uptime Son 24 saat, 7 gün ve 30 gün için yüzde olarak uptime
GET /monitors/{id}/daily-uptime Takvim günü başına uptime (UTC), days 1–90, varsayılan 30
GET /monitors/{id}/response-times Konum başına yanıt süresi ve erişilebilirlik, range 24h, 7d veya 30d; saatlik noktalar, 30d için günlük

Uptime:

curl https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/uptime \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"

{"data": {"24h": 100, "7d": 99.952, "30d": 99.987}}

Yanıt süreleri (kısaltılmış):

curl "https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/response-times?range=24h" \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"

{
  "data": {
    "range": "24h",
    "locations": {
      "eu": [
        {"time": "2026-11-15T07:00:00+00:00", "avg_ms": 212.4, "min_ms": 180, "max_ms": 402, "availability": 100},
        {"time": "2026-11-15T08:00:00+00:00", "avg_ms": 230.1, "min_ms": 190, "max_ms": 388, "availability": 100}
      ],
      "sg": [
        {"time": "2026-11-15T07:00:00+00:00", "avg_ms": 512.8, "min_ms": 470, "max_ms": 790, "availability": 100}
      ]
    }
  }
}

Sunucular

Sunucu, üzerinde CPU, bellek, yük, diskler, ağ ve servisleri raporlayan ajanın çalıştığı bir makinedir. Sunucu oluşturmak tek seferlik kurulum komutunu döndürür; komutu makinede çalıştırın, sunucu kısa süre sonra görünür.

Uç noktaNe yapar
GET /servers Listeler; filtre ids
POST /servers Oluşturur; yanıt install_command (Linux) ve install_command_freebsd içerir
GET /servers/{id} Envanteri, son anlık görüntüsü ve eşikleriyle tek bir sunucu
PATCH /servers/{id} Yeniden adlandırır, izlenen services değerlerini seçer, thresholds değerlerini ayarlar
DELETE /servers/{id} Siler (204); ajan izlemeden kaldırılır
POST /servers/{id}/pause Duraklatır; açık olaylar kapatılır
POST /servers/{id}/resume Sürdürür
POST /servers/{id}/install-token Yeni kurulum komutu; rotate_key=true ayrıca yeni bir ajan anahtarı verir
GET /servers/{id}/metrics Grafik serileri, range 24h, 7d veya 30d: metrik → bağlam → [unix time, avg, min, max]
AlanAçıklama
name Görünen ad, en fazla 100 karakter. Oluştururken zorunlu.
services Ajanın izlemesi gereken servis adları, örneğin ["nginx", "php8.4-fpm", "mariadb"]; en fazla 200. Sunucu bulduklarını discovered.services altında bildirir.
thresholds Uyarı eşikleri: cpu_max (yüzde), load_max_per_cpu, mem_min_pavail (boş yüzdesi), fs_warn ve fs_crit (kullanılan yüzde), inode_warn, agent_nodata_minutes, bağlama noktası başına filesystems altında ve düzenli ifadeler fs_types, fs_exclude, net_exclude. Belirtilmeyen değerler varsayılanlarını korur.

Bir sunucu ekleyin ve kurulum komutunu yanıttan okuyun:

curl -X POST https://app.centoculus.com/api/v1/servers \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name": "web-1"}'

{
  "data": {
    "id": "a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58",
    "customer_id": 1207,
    "name": "web-1",
    "status": "pending",
    "is_paused": false,
    "provisioning": {"state": "pending"},
    "services": [],
    "install_token_expires_at": "2026-11-16T08:30:12.000000Z",
    "install_command": "curl -fsSL https://app.centoculus.com/install/K7xQ2mVt9…Rd | sudo sh",
    "install_command_freebsd": "fetch -qo - https://app.centoculus.com/install/K7xQ2mVt9…Rd | sh",
    "created_at": "2026-11-15T08:30:12.000000Z"
  }
}

Üç servisi izleyin ve disk kullanımı yüzde 80 olunca uyarın:

curl -X PATCH https://app.centoculus.com/api/v1/servers/a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58 \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "services": ["nginx", "php8.4-fpm", "mariadb"],
    "thresholds": {"fs_warn": 80, "fs_crit": 90}
  }'

Olaylar

Olay, bir monitörün veya sunucunun started_at ile resolved_at arasındaki tek bir kesintisi veya uyarısıdır. Her olay, uyarı e-postasında görünenle aynı olan uyarı numarasını taşır.

Uç noktaNe yapar
GET /incidents En yeni ilk sırada; filtreler monitor_id, status (open veya closed), open=1 (duyurusuz açık kesintiler), from ve to (tarihler)
GET /incidents/{id} Zaman çizelgesiyle tek bir olay: hangi konumun ne zaman düştüğü ve düzeldiği ve olayı çözen onarım (fix)

Açık olaylar:

curl "https://app.centoculus.com/api/v1/incidents?status=open&per_page=10" \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"

{
  "data": [
    {
      "id": 90412,
      "monitor_id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
      "monitor_name": "Shop",
      "server_id": null,
      "subject_type": "monitor",
      "severity": "major",
      "cause": "unreachable",
      "started_at": "2026-11-15T09:14:03.000000Z",
      "resolved_at": null,
      "duration_seconds": 241,
      "alert_number": 101,
      "alert_label": "Incident #101",
      "affected_locations": ["eu", "sg"],
      "failure_reason": "HTTP 502 instead of 200-399",
      "fix": null
    }
  ],
  "links": {"first": "…?page=1", "last": "…?page=1", "prev": null, "next": null},
  "meta": {"current_page": 1, "from": 1, "last_page": 1, "per_page": 10, "to": 1, "total": 1}
}

Yararlı alanlar: subject_type (monitor veya server), severity (major, warning, info), cause (örneğin unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations ve olay açıkken en son kontrol değerleriyle failure_reason.

Durum sayfaları

Durum sayfası, seçili monitörleri kamuya veya ekibinize, bizim alan adımız altında ya da kendi alan adınızda gösterir. Duyurular bakımı bildirir veya süren bir olayı açıklar.

Uç noktaNe yapar
GET /status-pages Listeler
POST /status-pages Oluşturur
GET /status-pages/{id} Monitörleri, duyuruları ve alan adlarının durumuyla tek bir sayfa
PATCH /status-pages/{id} Günceller; monitors tüm listeyi değiştirir
DELETE /status-pages/{id} Siler (204)
POST /status-pages/{id}/notices Duyuru ekler
PUT /status-pages/{id}/notices/{notice} Duyuruyu günceller
DELETE /status-pages/{id}/notices/{notice} Duyuruyu kaldırır (204)
AlanAçıklama
slug Adres parçası, 3–63 karakter, küçük harfler, rakamlar ve tire; benzersiz. Zorunlu.
title Sayfanın başlığı. Zorunlu.
description Başlığın altındaki kısa metin, en fazla 2000 karakter.
logo_url Bir logonun HTTPS adresi.
custom_domain status.example.com gibi kendi alan adınız; kendi durum alan adlarını içeren bir plan gerekir.
is_public Herkese açık (true) veya yalnızca oturum açmış kullanıcılara.
monitors {"id": "<monitor UUID>", "display_name": "…", "group": "…"} öğelerinden oluşan sıralı liste; display_name ve group isteğe bağlıdır.

Bir duyurunun kind (maintenance, info veya incident), title, body (isteğe bağlı, en fazla 5000 karakter), starts_at ve isteğe bağlı ends_at alanları vardır.

İki monitörlü herkese açık bir durum sayfası oluşturun:

curl -X POST https://app.centoculus.com/api/v1/status-pages \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "example-status",
    "title": "Example status",
    "is_public": true,
    "monitors": [
      {"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "display_name": "Online shop", "group": "Web"},
      {"id": "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f", "group": "Web"}
    ]
  }'

Bir bakım penceresi duyurun:

curl -X POST https://app.centoculus.com/api/v1/status-pages/318/notices \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "maintenance",
    "title": "Database upgrade",
    "body": "Checkout will be unavailable for about 15 minutes.",
    "starts_at": "2026-11-20T01:00:00Z",
    "ends_at": "2026-11-20T01:30:00Z"
  }'

Bildirim kanalları

Bildirim kanalı, birine ulaşmanın bir yoludur: bir e-posta adresi, bir Telegram sohbeti, bir webhook veya bir kullanıcının push cihazları. Bir kanal çalışma alanındaki tüm monitörlerin ya da yalnızca monitor_ids içindeki monitörlerin uyarılarını alır. Planınızın hangi kanal türlerini içerdiği: GET /notification-channel-types.

Uç noktaNe yapar
GET /notification-channels Listeler
POST /notification-channels Oluşturur; webhook için imzalama anahtarı secret yalnızca bu yanıtta bulunur
GET /notification-channels/{id} Tek bir kanal
PATCH /notification-channels/{id} Günceller; tür değiştirilemez
DELETE /notification-channels/{id} Siler (204)
POST /notification-channels/{id}/test Test bildirimi gönderir (202); onaylanmamış bir e-posta adresi bunun yerine onay bağlantısını yeniden alır
GET /notification-channel-types available ve paid ile kanal türleri
AlanAçıklama
type email, telegram, webhook veya push. Zorunlu, sonradan değiştirilemez.
name Görünen ad. Zorunlu.
config Türe göre: {"email": "…"}, {"chat_id": "…"} veya {"url": "https://…"}. Push için config gerekmez. Yeni bir e-posta adresi, uyarılar gitmeden önce bağlantıyla onaylanmalıdır.
monitor_ids Bu kanalın ilgilendiği monitörlerin UUID değerleri; tüm monitörler için boş bırakın.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: bu zaman aralığında uyarı yok.
escalation_delay_minutes Bu kanalı yalnızca kesinti bu kadar sürerse uyarın (0–1440).
notify_recovery Sorunun giderildiği bilgisini de gönderin (true veya false).
is_active Kanalı silmeden açın veya kapatın.

İki monitör için bir webhook kanalı oluşturun ve secret değerini saklayın:

curl -X POST https://app.centoculus.com/api/v1/notification-channels \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "webhook",
    "name": "Ops bot",
    "config": {"url": "https://hooks.example.com/centoculus"},
    "monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
    "notify_recovery": true
  }'

{
  "data": {
    "id": 512,
    "customer_id": 1207,
    "type": "webhook",
    "name": "Ops bot",
    "config": {"url": "https://hooks.example.com/centoculus", "secret": "wq7Hc2…48 characters…Zp"},
    "quiet_hours": null,
    "escalation_delay_minutes": 0,
    "notify_recovery": true,
    "is_active": true,
    "confirmed": true,
    "monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
    "created_at": "2026-11-15T08:41:55.000000Z",
    "updated_at": "2026-11-15T08:41:55.000000Z"
  }
}

Webhook yükü

Bir webhook kanalı her uyarıyı JSON olarak URL adresinize POST eder; zaman aşımı 10 saniyedir ve yönlendirme izlenmez. Hedef herkese açık bir adres olmalıdır.

Başlıklar: X-Webhook-Timestamp (Unix zamanı), X-Webhook-Signature (sha256= ve ardından anahtar olarak kanal secret değeriyle <timestamp>.<body> üzerinden HMAC-SHA256) ve User-Agent: Uptime-Webhook/1.

event değeri down, recovered, paused veya test olur. Bir monitör uyarısında gövde monitor (id, name, target) ve incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations) taşır; bir sunucu uyarısında server (id, name) ve konumlar yerine problem içeren incident taşır. subject, uyarının kanal dilindeki başlığıdır.

Bir down uyarısının gövdesi:

POST /your-endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Uptime-Webhook/1
X-Webhook-Timestamp: 1794912843
X-Webhook-Signature: sha256=3f1b9c…e2a7

{
  "event": "down",
  "monitor": {"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "name": "Shop", "target": "https://shop.example.com"},
  "incident": {
    "id": 90412,
    "severity": "major",
    "cause": "unreachable",
    "started_at": "2026-11-15T09:14:03+00:00",
    "resolved_at": null,
    "duration_seconds": 0,
    "affected_locations": ["eu", "sg"]
  },
  "subject": "DOWN: Shop"
}

Gövdeye güvenmeden önce imzayı doğrulayın: HMAC değerini ham gövde üzerinden, tam olarak alındığı haliyle hesaplayın ve sabit sürede karşılaştırın. Birkaç dakikadan eski zaman damgalarını reddedin.

İmzayı kabukta kontrol etme:

expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"

Pano özeti

GET /dashboard, genel bakıştaki kutucukların arkasındaki sayıları döndürür: duruma göre monitörler (sunucular plan birimleriyle sayılır), duruma göre sunucular ve açık olay sayısı. monitors:read, servers:read veya incidents:read kapsamlarından herhangi biri erişim sağlar.

curl https://app.centoculus.com/api/v1/dashboard \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"

{
  "data": {
    "monitors": {"pending": 0, "up": 46, "degraded": 1, "down": 1, "paused": 2},
    "monitors_total": 50,
    "servers": {"pending": 0, "up": 3, "degraded": 0, "down": 0, "paused": 0},
    "open_incidents": 2
  }
}

Sık sorulan sorular

Hangi plan API içerir?

API tokenları Business planı ve üzerinde sunulur. Daha küçük planlarda bölümü Hesabım altında devre dışı ve bir yükseltme bağlantısıyla görürsünüz. Centoculus içindeki diğer her şey API olmadan çalışır.

Bir token hesabımın yapabildiği her şeyi yapabilir mi?

Hayır. Bir token yalnızca kapsam verdiğiniz alanlara erişir; faturalamaya, ekip üyelerine, diğer tokenlara, hesap güvenliğine ve onarımlara (fixes) asla erişemez. Bunlar uygulamada kalır.

Sandbox var mı?

Keşfetmek için yalnızca okuma kapsamlı bir token kullanın, test monitörlerini ise ikinci bir hesabın ücretsiz planında oluşturun. Oluşturduğunuz monitörler, uygulamada oluşturulanlar gibi planınıza sayılır.

Uyarıları kendi sistemime nasıl alırım?

Bir webhook kanalı oluşturun ve her teslimatın imzasını doğrulayın. Her kesinti, düzelme ve duraklatma saniyeler içinde URL adresinize ulaşır; monitör, neden ve etkilenen konumlar JSON olarak gelir.

API değişir mi?

Sürüm adreste yer alır (/api/v1). Yanıtlara istediği zaman yeni alanlar eklenebilir; bir sürüm içinde alanlar kaldırılmaz veya yeniden adlandırılmaz. İhtiyacınız olanı okuyun, gerisini yok sayın.

İzlemenizi otomatikleştirmeye hazır mısınız?

API tokenları Business planı ve üzerine dahildir. Planları karşılaştırın veya ücretsiz başlayın ve betikleriniz hazır olunca yükseltin.