Kendi araçlarınızla bağlayın
WAM, panelin kullandığı aynı REST API'yi sunar. Bugün yedek heartbeat, GitHub ve imzalı bildirim webhook'ları canlıdır; kalanlar yol haritasındadır.
- Canlı
REST API
Panelin kullandığı /api/v1 uçları: JSON, Bearer erişim belirteci, RFC 7807 hata gövdeleri.
- Canlı
Yedek heartbeat
Yedek script'inizin sonunda tek bir istek: başarılı mı, ne kadar sürdü, boyutu ne. Gecikme ve hata uyarıya dönüşür.
- Canlı
GitHub webhook
GitHub App olayları imzalı webhook ile alınır (HMAC, sabit zamanlı doğrulama); deployment ve commit durumu anında güncellenir.
- Yakında
API anahtarları ve OpenAPI
Kapsamlı, iptal edilebilir API anahtarları, hız sınırları ve OpenAPI şeması ile interaktif belgeler.
- Canlı
İmzalı bildirim webhook'ları
Uyarıları JSON olarak, HMAC-SHA256 imzalı webhook ile gönderin; yalnızca genel (public) adreslere gider.
- Yakında
Prometheus ve Grafana
Prometheus uyumlu metrik ucu ve hazır Grafana panoları ile kendi gözlem yığınınıza bağlayın.
Kimlik doğrulama akışı
Panelin kullandığı aynı API'ye oturum belirteciyle bağlanırsınız. Erişim belirteci kısa ömürlüdür; süresi dolunca yenileme çerezi yeni belirteç verir.
Bugün API oturum belirteciyle çalışır. Kapsamlı, iptal edilebilir API anahtarları yol haritasındadır. Yedek heartbeat ve webhook uçları kendi belirteçleriyle ayrıca çalışır.
Uç katalogu
Sık kullanılan uçlardan seçmeler. Tümü /api/v1 altındadır; izinler rolünüze göre uygulanır.
Kimlik
- POST
/auth/loginE-posta + şifre → erişim belirteci - POST
/auth/refreshYeni erişim belirteci (rotasyonlu çerez) - GET
/auth/meKullanıcı, organizasyon, rol ve izinler
Website ve domain
- GET
/websitesListe (cursor ile sayfalı) - POST
/websitesWebsite ekle (plan limiti uygulanır) - GET
/websites/{id}/monitorUptime izleme ayarları - GET
/domainsDomain listesi, bitiş tarihi, registrar
Uyarı ve görev
- GET
/alertsAktif, çözülmüş, tümü - POST
/alerts/{id}/resolveManuel çözüldü işareti - GET
/alerts/rulesEtkin kurallar (varsayılan + organizasyon)
Kod ve yedek
- GET
/repositoriesRepo listesi, son commit - GET
/deploymentsProduction deployment durumu - POST
/backups/targetsYedek hedefi + tek seferlik token - POST
/backups/targets/{id}/rotate-tokenToken'ı yenile
Dış girişler
- POST
/ingest/backupsYedek sonucu bildir (Bearer token) - POST
/webhooks/githubGitHub App olayları (HMAC imzalı)
Genel
- GET
/public/plansSatışa açık planlar ve limitler - GET
/dashboard/summaryKPI'lar ve aksiyon gereken öğeler - GET
/exports/websitesFiltreli website dışa aktarımı (domain için /exports/domains)
Webhook doğrulama
GitHub App olayları imzalı gelir. İmza ham gövde üzerinden sabit zamanlı karşılaştırılır; geçerliyse hemen 202 döner, işleme arka planda yapılır.
Hata sözleşmesi
Tüm hatalar RFC 7807 application/problem+json olarak döner; doğrulama hatalarında alan bazlı errors nesnesi bulunur.
400Doğrulama hatası401Belirteç yok ya da geçersiz403İzin veya modül hakkı yok404Bulunamadı (başka organizasyonun kaydı da 404 döner)409Çakışma ya da plan limiti aşımı (PLAN_LIMIT_EXCEEDED)429Hız sınırı aşıldı
{
"title": "Plan limit reached",
"status": 409,
"detail": "Website limit for your plan has been reached.",
"error_code": "PLAN_LIMIT_EXCEEDED"
}Cursor sayfalama
Liste uçları offset yerine opak cursor kullanır: büyük veride de sabit maliyet.
GET /api/v1/websites?limit=50&cursor=eyJ0IjoiMjAyNi0xMC0wNyIsImlkIjoiLi4uIn0
{
"items": [ … ],
"nextCursor": "eyJ0IjoiMjAyNi0xMC0wNiIs…"
}Sınırlar
- Yedek heartbeat: belirteç başına dakikada 60 istek.
- Plan limiti aşımı: 409 ve error_code: PLAN_LIMIT_EXCEEDED.
Yedek heartbeat örneği
Belirteç yalnızca Authorization başlığında taşınır. WAM yalnızca sonucu alır; yedek dosyasına erişmez.
Belirteci website detay sayfasındaki Backup bölümünden oluşturursunuz.
Yanıtlar
202Kabul edildi, runId döner400Geçersiz gövde401Belirteç eksik ya da geçersiz429Belirteç başına dakikada 60 istek aşıldı
curl -sS -X POST "https://wamdesk.com/api/v1/ingest/backups" \
-H "Authorization: Bearer $WAM_BACKUP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"status":"SUCCESS","sizeBytes":123456789,"durationSec":94,"location":"r2://backups/2026-10-07.sql.gz","message":"nightly backup"}'Bir uç eksik mi?
Hangi otomasyona ihtiyacınız olduğunu yazın; yol haritasını buna göre sıralıyoruz.