Yardım ve kılavuzlarAPI ve entegrasyonlar › API endpoint genel bakış

API endpoint genel bakış

5 dk okuma · API ve entegrasyonlar

Tüm kullanılabilir API endpoint'lerinin referansı. Base URL: https://epulz.io/api/v1

Yetkilendirme: Authorization: Bearer plz_.... Rate limit token başına dakikada 60 istek. Token'ı Ayarlar -> API token'lar bölümünde oluşturun.

Status / auth check

GET /status - token'ı doğrular, email, plan, monitör sayısı ve açık olayları döner

Monitors

GET /monitors - tüm monitörlerinizin listesi (24sa uptime ile) GET /monitors/{id} - tek monitör detayı POST /monitors - yeni monitör oluştur (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - toplu içe aktarma (istek başına max 200 monitör) DELETE /monitors/{id} - monitörü sil (check geçmişi ve olaylarla birlikte)

Checks (geçmiş)

GET /monitors/{id}/checks?limit=100 - son N kontrol (status, response time, status code, error, region). Limit 1-500, varsayılan 50.

Incidents

GET /incidents - olay listesi. İsteğe bağlı filtreler: monitor_id, resolved (true/false), limit (1-500, varsayılan 50).

Hata kodları

  • 401 - eksik veya geçersiz token
  • 403 - plan monitör limiti aşıldı (oluşturmada)
  • 404 - monitör size ait değil veya mevcut değil
  • 429 - rate limit aşıldı (60 req/dk)

Tam OpenAPI spesifikasyonu

Makine tarafından okunabilir spesifikasyon /api/openapi.json adresinde, interaktif dokümantasyon (Swagger UI) /api/docs adresinde. İkisi de giriş / token gerektirir.