11 — Bakım Modu, Duyurular ve Zorunlu Güncellemeler

Kimin için: Planlı bakım yönetimi, kesinti iletişimi ve mobil/masaüstü sürüm zorlama yapan geliştiriciler.
Ön koşul: Uygulama Yönetim API'si.
Tahmini süre: 15 dakika.

Ne Öğreneceksiniz

• TALOST ID üzerinde planlı veya anlık bakım modu başlatmayı,
• Bakım sırasında OAuth girişlerinin ve IdP yönlendirmelerinin nasıl davrandığını,
• Uygulama içinde duyuru bantlarını ve bakım ekranlarını göstermeyi,
• Mobil ve masaüstü istemcilerde zorunlu güncelleme (Forced Update) akışını.

Bakım Modu Davranış Mimarisi

Uygulamanızı Geliştirici Portalından veya Admin Konsolundan bakıma aldığınızda:

1. OAuth Girişleri: /oauth/authorize uç noktası, kullanıcı uygulamanın ekip üyesi veya platform yöneticisi değilse kullanıcıyı şifre sormadan doğrudan /oauth/bakim?app={slug} sayfasına yönlendirir.
2. Kullanıcı Paneli SSO: id.talost.com/panel üzerinden yapılan tek tıkla doğrudan girişler durdurulur ve kullanıcıya bakım açıklaması sunulur.
3. API ve İstemciler: GET /api/v1/apps/status uç noktası maintenance.active = true döner.
4. Webhook: Kayıtlı webhook adresinize app.maintenance.started ve bakım bittiğinde app.maintenance.ended olayları gönderilir.

Zorunlu Güncelleme Akışı (Mobil ve Masaüstü)

Masaüstü (Electron, .NET) veya mobil (iOS, Android) uygulamanız açılırken:

// versionCheck.ts
export async function checkAppVersion(currentVersion: string) {
  const clientId = "cli_live_xxxxxxxx";
  const res = await fetch(
    `https://id.talost.com/api/v1/apps/version-check?client_id=${clientId}&platform=WINDOWS&version=${currentVersion}`
  );

  if (!res.ok) return;

  const data = await res.json();

  if (data.forced_update) {
    // 1. Durum: Zorunlu Güncelleme — Kullanım engellenmeli
    showForcedUpdateModal({
      latest: data.latest_version,
      url: data.download_url,
    });
  } else if (data.update_available) {
    // 2. Durum: İsteğe Bağlı Güncelleme — Bildirim göster
    showOptionalUpdateBanner({
      latest: data.latest_version,
      url: data.download_url,
    });
  }
}

Uygulama İçi Bakım ve Duyuru Kontrolü

Uygulama sunucunuz veya frontend uygulamanız periyodik olarak veya açılışta GET /api/v1/apps/status yanıtını okuyarak kullanıcılarına uyarı bandı çıkarabilir:

// status.ts
export async function getEcosystemStatus() {
  const res = await fetch("https://id.talost.com/api/v1/apps/status", {
    headers: { "X-Talost-Api-Key": process.env.TALOST_APP_API_KEY! },
    next: { revalidate: 30 }, // 30 saniye önbellek
  });

  const data = await res.json();
  return data;
}

İlgili Sayfalar

• 10. Uygulama Yönetim API'si
• 09. Webhooklar
• 16. Test ve Teşhis Araçları

Son doğrulama: 2026-10-04 · Kaynak: _envanter.md, src/lib/apps/announcements.ts, src/app/oauth/bakim/page.tsx