Durum Referansı

status.chainabit.com, Chainabit API için genel durum yüzeyidir. Tüm uç noktalar anonimdir, önbellek dostudur ve standart yanıt zarfını (EN) döndürür.

Temel URL

https://status.chainabit.com/api/v1

Uç Noktalar

Yöntem	Yol	Amaç
GET	/status	Platform özeti
GET	/status/services	Hizmet listesi
GET	/status/services/:slug	Hizmet detayı
GET	/status/components	Bileşen listesi
GET	/status/incidents	Olay akışı
GET	/status/incidents/:id	Olay detayı
GET	/status/maintenance	Bakım pencereleri
GET	/status/snapshots/:date	Geçmiş günlük anlık görüntü
GET	/status/uptime/:window	Çalışma süresi özeti

---

GET /status

Mevcut platform özetini döndürür: genel durum, hizmet kartları, en önemli olaylar ve aktif bakım.

Yanıt

{
  "data": {
    "headline": "All systems operational",
    "status": "operational",
    "indicator": "operational",
    "updatedAt": "2026-10-01T09:14:38.372Z",
    "lastCheckedAt": "2026-10-01T09:14:38.372Z",
    "services": [
      {
        "slug": "api",
        "name": "Chainabit API",
        "status": "operational",
        "indicator": "operational",
        "openIncidents": 0,
        "activeMaintenance": false,
        "uptime": {
          "24h": 99.9,
          "7d": 99.9,
          "30d": 99.9,
          "90d": 99.9,
          "1y": 99.9
        }
      }
    ],
    "incidents": [],
    "maintenance": []
  }
}

status değerleri: operational · degraded_performance · partial_outage · major_outage · maintenance

---

GET /status/services

Genel hizmetlerin listesini sort_order'a göre sıralanmış olarak döndürür.

Yanıt

{
  "data": [
    {
      "id": "uuid",
      "slug": "api",
      "name": "Chainabit API",
      "description": "Primary API surface for Chainabit platform requests.",
      "current_status": "operational",
      "indicator": "operational",
      "payload": {
        "slug": "api",
        "status": "operational",
        "openIncidents": 0,
        "activeMaintenance": false
      },
      "sort_order": 0,
      "is_public": true,
      "created_at": "2026-03-25T00:00:00.000Z",
      "updated_at": "2026-03-25T00:00:00.000Z"
    }
  ]
}

---

GET /status/services/:slug

Bileşenleri, açık olayları, aktif bakımı ve çalışma süresi pencereleri ile birlikte bir hizmeti döndürür.

Yol parametreleri

Parametre	Tür	Açıklama
slug	string	Hizmet slug'ı (örneğin api)

Yanıt

{
  "data": {
    "service": {
      "id": "uuid",
      "slug": "api",
      "name": "Chainabit API",
      "description": "Primary API surface for Chainabit platform requests.",
      "current_status": "operational",
      "indicator": "operational"
    },
    "components": [
      {
        "id": "uuid",
        "slug": "api-health",
        "name": "API Health Checks",
        "current_status": "operational"
      }
    ],
    "incidents": [],
    "maintenance": [],
    "uptime": {
      "24h": 100,
      "7d": 99.98,
      "30d": 99.95,
      "90d": 99.9,
      "1y": 99.85
    }
  }
}

---

GET /status/components

Tüm genel bileşenleri döndürür. İsteğe bağlı olarak hizmete göre filtreleyin.

Sorgu parametreleri

Parametre	Tür	Gerekli	Açıklama
serviceSlug	string	Hayır	Bileşenleri belirli bir hizmete göre filtreleyin

Yanıt

{
  "data": [
    {
      "id": "uuid",
      "slug": "api-health",
      "name": "API Health Checks",
      "current_status": "operational",
      "indicator": "operational",
      "service_id": "uuid"
    }
  ]
}

---

GET /status/incidents

En yenisi ilk sırada olmak üzere genel olay akışını döndürür.

Sorgu parametreleri

Parametre	Tür	Gerekli	Açıklama
offset	number	Hayır	Atlanacak olay sayısı (varsayılan: 0)
limit	number	Hayır	Sayfa başına öğe (varsayılan: 20, maksimum: 100)

Yanıt

{
  "data": [
    {
      "id": "uuid",
      "slug": "api-degraded-2026-03-25",
      "title": "API degraded performance",
      "status": "resolved",
      "impact": "minor",
      "severity": null,
      "description": "Elevated error rates observed.",
      "started_at": "2026-03-25T10:00:00.000Z",
      "resolved_at": "2026-03-25T11:30:00.000Z",
      "updates": []
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

Olay mevcut değilse error.code: "not_found" ile 404 döner.

status değerleri: investigating · identified · monitoring · resolved · postmortem_readyimpact değerleri: minor · partial · major

---

GET /status/incidents/:id

Tam güncelleme zaman çizelgesiyle birlikte tek bir olayı döndürür.

Yol parametreleri

Parametre	Tür	Açıklama
id	string	Olay UUID'si

Yanıt

{
  "data": {
    "id": "uuid",
    "slug": "api-degraded-2026-03-25",
    "title": "API degraded performance",
    "status": "resolved",
    "impact": "minor",
    "started_at": "2026-03-25T10:00:00.000Z",
    "resolved_at": "2026-03-25T11:30:00.000Z",
    "updates": [
      {
        "id": "uuid",
        "status": "investigating",
        "message": "We are investigating elevated error rates.",
        "author_name": "Chainabit Ops",
        "created_at": "2026-03-25T10:05:00.000Z"
      },
      {
        "id": "uuid",
        "status": "resolved",
        "message": "Issue resolved. Root cause was a misconfigured upstream proxy.",
        "author_name": "Chainabit Ops",
        "created_at": "2026-03-25T11:30:00.000Z"
      }
    ]
  }
}

---

GET /status/maintenance

Yaklaşan ve aktif bakım pencerelerini döndürür.

Yanıt

{
  "data": [
    {
      "id": "uuid",
      "slug": "db-upgrade-2026-03-26",
      "title": "Database upgrade",
      "status": "scheduled",
      "starts_at": "2026-03-26T02:00:00.000Z",
      "ends_at": "2026-03-26T04:00:00.000Z",
      "service_id": "uuid"
    }
  ]
}

status değerleri: scheduled · in_progress · completed · cancelled

---

GET /status/snapshots/:date

Belirtilen tarih için geçmiş günlük anlık görüntüyü döndürür.

Yol parametreleri

Parametre	Tür	Açıklama
date	string	YYYY-MM-DD formatında ISO tarihi

Örnek istek

curl https://status.chainabit.com/api/v1/status/snapshots/2026-10-01

Yanıt

{
  "data": {
    "snapshotDate": "2026-10-01",
    "status": "operational",
    "indicator": "operational",
    "headline": "All systems operational",
    "services": [],
    "incidents": [],
    "maintenance": []
  }
}

İstenen tarih için anlık görüntü yoksa error.code: "not_found" ile 404 döner.

---

GET /status/uptime/:window

Belirli bir zaman penceresi için çalışma süresi özetini döndürür.

Yol parametreleri

Parametre	Tür	Açıklama
window	string	Şunlardan biri: 24h · 7d · 30d · 90d · 1y

Örnek istek

curl https://status.chainabit.com/api/v1/status/uptime/30d

Yanıt

{
  "data": {
    "window": "30d",
    "scopeType": "platform",
    "scopeKey": "global",
    "uptimePercent": 99.95,
    "downtimeMinutes": 21.6,
    "incidentCount": 2,
    "computedAt": "2026-10-01T00:00:00.000Z",
    "dailyHistory": [
      {
        "date": "2026-10-01",
        "uptimePercent": 99.95
      }
    ]
  }
}

---

Önbellek başlıkları

Her yanıt şunları içerir:

Başlık	Değer
Cache-Control	public, max-age=30, stale-while-revalidate=300
ETag	Serileştirilmiş yükün SHA-1'i
Last-Modified	Projeksiyon zaman damgası

Değişmemiş yüklerin aktarımını önlemek için koşullu istekler (If-None-Match, If-Modified-Since) kullanın.

---

İstemci rehberliği

• Açılış sayfası hero alanı için /status kullanın.
• Hizmet başına detay sayfaları için /status/services/:slug kullanın.
• Tarih tabanlı geçmiş ve SEO için /status/snapshots/:date kullanın.
• Kompakt yüzde widget'ları için /status/uptime/:window kullanın.
• stale-while-revalidate veya önbellek farkında yoklamayı tercih edin — istek patlamalarından kaçının.