Genel Bakış
Anchor Uptime API, site-scoped plugin token ile çalışan REST endpoint’lerinden oluşur.
Giriş
Public API base URL değeri https://status.anchoruptime.com/api/v1 adresidir. Siteye özel plugin token ile kimlik doğrulanan endpoint’ler /sites/{site} altında toplanır.
Site parametresi numeric ID’dir.
API path'lerindeki {site} alanı site adı değil, sayısal site ID'sidir.
Kimlik Doğrulama
Tokenlar hidden site token olarak üretilir ve her token yalnızca tek bir site_id kapsamına sahiptir. Authorization başlığında Bearer şemasıyla gönderilir.
HTTP
Authorization: Bearer dku_a1b2c3d4_4f8b91c2e8d04b46a1d7f2aa6c93e5fd
Endpoint Kataloğu
| Method | Path | Not |
|---|---|---|
| GET | /healthz |
Auth gerektirmez. |
| POST | /plugin/ownership-connect |
Verification token ile hidden plugin token üretir. |
| GET | /sites/{site}/status |
Birleşik site durumu. |
| GET | /sites/{site}/metrics |
avg ve p95 latency özeti. |
| GET | /sites/{site}/incidents |
Son 20 incident + 30 günlük uptime. |
| GET | /sites/{site}/domain-ssl |
Ücretli planlar için SSL/domain verisi. |
| GET | /sites/{site}/audit-log |
Activity log sayfalaması. |
| GET | /sites/{site}/token-info |
Token health ve capability listesi. |
| GET | /sites/{site}/verify/token |
Plugin için verification tokenı döndürür. |
| POST | /sites/{site}/maintenance |
Site maintenance flagini değiştirir. |
| POST | /sites/{site}/fatal |
Plugin fatal raporu gönderir. |
Rate Limit
| Grup | Limit | Kapsam |
|---|---|---|
| Site endpoint’leri | 30 / 1 dk | /sites/{site} altındaki çoğu GET/POST çağrısı |
| Ownership connect | 10 / 1 dk | /plugin/ownership-connect |
| Fatal report | 10 / 1 dk | /sites/{site}/fatal |
| Panel verify start/check | 5 / 1 dk | Auth gerektiren panel doğrulama endpoint’leri |
Yaygın Hatalar
- 401: Bearer token eksik, geçersiz, expired veya revoked.
- 403: Token geçersiz kapsamda kullanıldı.
- 402: Premium plan gerektiren endpoint ücretli olmayan hesapta çağrıldı.
- 429: Route throttling sınırı aşıldı.