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.
- Web uygulamasında veya mobil uygulamada Hesabım → API tokenları bölümünden bir token oluşturun ve kapsamlarını seçin.
- Tokenı hemen kopyalayın; yalnızca bir kez gösterilir.
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:read | Monitörleri listeleme ve görüntüleme, uptime, günlük uptime, yanıt süreleri, kontrol türleri, konumlar, pano özeti |
monitors:write | Monitör oluşturma, güncelleme, silme, duraklatma ve sürdürme |
servers:read | Sunucuları ve metriklerini listeleme ve görüntüleme |
servers:write | Sunucu oluşturma, güncelleme, silme, duraklatma ve sürdürme; ajan için yeni kurulum komutu |
incidents:read | Olayları listeleme ve görüntüleme, pano özeti |
status-pages:read | Durum sayfalarını listeleme ve görüntüleme |
status-pages:write | Durum sayfalarını ve duyurularını oluşturma, güncelleme ve silme |
notifications:read | Bildirim kanallarını ve kanal türlerini listeleme ve görüntüleme |
notifications:write | Kanal (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
dataaltında, bir liste iselinksvemetaile birliktedataaltı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
pageveper_pagesorgu parametreleriyle sayfalanır;metaiçindecurrent_page,last_page,per_pagevetotalbulunur. 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_idgö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-Afterile 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.
| Durum | Anlamı |
|---|---|
401 | Token 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. |
403 | Tokenda kapsam yok, uç nokta API tokenlarına kapalı veya planınız bu özelliği içermiyor. |
404 | Bulunamadı ya da çalışma alanınızda değil. |
409 | Çakışma, örneğin zaten onaylanmış bir e-posta adresini onaylamak. |
422 | Doğ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. |
429 | Sı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ç nokta | Ne 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
| Alan | Açı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ç nokta | Ne 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ç nokta | Ne 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] |
| Alan | Açı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ç nokta | Ne 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ç nokta | Ne 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) |
| Alan | Açı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ç nokta | Ne 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 |
| Alan | Açı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.