Uptime Garantileri
| Plan | Hedef uptime | İhlal durumunda kredi tazminatı |
|---|---|---|
| Free | garanti yok | tazminat yok |
| Indie | 99 % | her %0.1 için aylık ücretin %5’i |
| Starter | 99.9 % | her %0.1 için aylık ücretin %10’u |
| Pro | 99.9 % | her %0.1 için aylık ücretin %25’i |
| Business | 99.95 % | her %0.1 için aylık ücretin %50’si |
| Enterprise | 99.99 % + özel | sözleşmeye göre, yazılı SLA |
Uptime, takvim ayı boyunca https://api.astroway.info/v1/health yanıtı HTTP 200 ve 1 000 ms içinde ölçülür. Planlı bakım (en az 48 saat önceden durum sayfası üzerinden duyurulur) hesaplamaya dahil edilmez.
Hedef gecikmeler
api.astroway.info/v1/* üzerinde tek bir bölgeden ölçülür, sadece sunucu işlem süresi (istemci ve ağ gecikmesi dahil değildir). Tam çeyrek dönem raporu durum sayfası üzerinden yayınlanır.
Standart endpoint’ler
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return ve benzerleri.
| Metrik | Hedef | Gerçek (içsel örnekleme, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Disclaimer: sayılar gerçek - içsel örnekleme api-calc izleme sisteminden, public production-telemetry dashboard roadmap’ta. Dikkat: p99 = highest extremes, bu yüzden süre p50’den çok daha yüksek.
Ağır endpoint’ler
Çok günlük toplama işlemleri: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metrik | Hedef | Gerçek (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1.9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1.9 s |
Düzeltme
POST /v1/rectification (120 s’ye kadar) ve POST /v1/rectification/trutine (15 s’ye kadar) doğaları gereği uzun sürelidir ve gecikme SLA’sına dahil değildir. Request-Timeout başlığını 180 s’ye kadar saygı gösterirler.
Hız sınırlaması
Anahtar için yumuşak sınırlama rateLimitMiddleware içinde, HTTP 429 ve Retry-After başlığı döner.
| Plan | Dakika başına istek | Aylık kredi bütçesi |
|---|---|---|
| Free | 10 | 10 000 |
| Indie | 30 | 50 000 |
| Starter | 120 | 200 000 |
| Pro | 400 | 800 000 |
| Business | 1 000 | 3 500 000 |
| Enterprise | custom | limitsiz |
Public sandbox (POST /v1/public/chart) IP bazlı sınırlıdır - saat başına 30 istek, API anahtarı olmadan.
İstek kimliği
Her yanıt X-Request-Id (UUID) başlığı içerir. Olay bildirirken ekle - 30 gün access loglarını saklarız ve sadece request-id ile çağrını tamamen yeniden oluşturabiliriz.
HTTP 5xx durumunda aynı kimlik yanıt gövdesinde tekrarlanır:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Olaylara yanıt
| Seviye | Tanım | Yanıt SLA’sı |
|---|---|---|
| SEV-1 | Tüm istekler düşüyor / bölgesel arıza | 15 dk içinde onay |
| SEV-2 | Tek bir endpoint arızası veya >%5 hata | 1 saat içinde onay |
| SEV-3 | Degradasyon gecikmesi (p95 > 2× hedef) | aynı iş günü içinde |
| SEV-4 | Kozmetik / tek bir müşterinin sorusu | ertesi iş günü |
Olayları support@astroway.info adresine request-id ile bildir. SEV-1 için ayrıca durum sayfasını kontrol et.
Versiyonlama ve deprecation
- Endpoint’ler
/v1/altında bulunur ve ana sürüm içinde geriye dönük uyumlu kalır. - Breaking changes
/v2/altında çıkar,/v1/ise ≥ 12 ay çalışmaya devam eder. - Alan eklemek breaking olarak kabul edilmez; istemciler bilinmeyen alanları görmezden gelmelidir.
- Deprecation changelog içinde duyurulur ve hesap sahiplerine e-posta ile en az 90 gün önceden gönderilir.
Destek kanalları
| Plan | Kanal | Yanıt |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 iş günü |
| Pro | email + öncelikli kuyruk | ≤ 4 iş saati |
| Enterprise | özel Slack / PagerDuty | sözleşmeye göre |