Garanti Hizmet Sürekliliği
| Plan | Hedef Hizmet Sürekliliği | Sözleşme ihlali durumunda kredi olarak telafi |
|---|---|---|
| Free | garantili değil | telafi yok |
| Indie | 99 % | her 0.1 % için aylık ödemenin %5’i |
| Starter | 99.9 % | her 0.1 % için aylık ödemenin %10’u |
| Pro | 99.9 % | her 0.1 % için aylık ödemenin %25’i |
| Business | 99.95 % | her 0.1 % için aylık ödemenin %50’si |
| Enterprise | 99.99 % + custom | sözleşmeye göre, yazılı SLA |
Hizmet sürekliği, https://api.astroway.info/v1/health adresine yapılan isteklerin
HTTP 200 yanıtı ve 1.000 ms içinde yanıt vermesi esas alınarak hesaplanır.
Planlı bakım çalışmaları (en az 48 saat önceden durum sayfası’nda duyurulur) hesaplamaya dahil edilmez.
Hedef Gecikmeler
api.astroway.info/v1/* adresindeki uç noktalar için, aynı bölgeden yapılan ölçümlerdir.
Sadece sunucu yanıt süresi dikkate alınır (istemci ve ağ gecikmesi hariç). Her çeyrek
raporu durum sayfasında yayınlanır.
Standart Uç Noktalar
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return ve benzeri.
| Metrik | Hedef | Gerçek (iç izleme, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Uyarı: Gerçek sayılar,
api-calcizleme sisteminden alınan iç veriler olup, halka açık üretim telemetri panosu yol haritasındadır. Dikkat et: p99 = en yüksek uç değerlerdir, bu yüzden p50’e göre çok daha yüksek olabilir.
Ağır Uç Noktalar
Çok günlük veri kümeleri: 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 |
Rektifikasyon
POST /v1/rectification (120 s’ye kadar) ve POST /v1/rectification/trutine
(15 s’ye kadar) doğaları gereği uzun süren işlemlerdir ve gecikme SLA’larına dahil değildir.
Request-Timeout başlığını 180 s’ye kadar desteklerler.
Sıklık Sınırları
Anahtar başına rateLimitMiddleware tarafından uygulanan yumuşak sınırlama.
HTTP 429 yanıtıyla birlikte Retry-After başlığını döndürür.
| Plan | İstek / dakika | 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 | sınırsız |
Halka açık sandbox (POST /v1/public/chart) IP bazlı olarak sınırlıdır — 30 istek / saat,
API anahtarı gerekmez.
İstek Tanımlama
Her yanıt X-Request-Id (UUID) başlığını içerir. Bir olay bildirirken bunu ekle,
çünkü access log’larını 30 gün boyunca saklıyoruz ve sadece request-id ile
çağrını tamamen yeniden oluşturabiliriz.
HTTP 5xx durumunda aynı tanımlayıcı yanıt gövdesinde de yer alır:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Olaylara Müdahale
| Seviye | Tanım | Yanıt SLA’sı |
|---|---|---|
| SEV-1 | Tüm istekler başarısız oluyor / bölgesel arıza | 15 dakika içinde onay |
| SEV-2 | Tek bir uç nokta arızası ya da >%5 hata oranı | 1 saat içinde onay |
| SEV-3 | Bozulmuş gecikme (p95 > 2× hedef) | aynı iş günü içinde |
| SEV-4 | Görsel / tek bir müşteri sorunu | sonraki iş günü |
Olayları support@astroway.info adresine request-id ile bildir. SEV-1 için
durum sayfasını da kontrol et.
Sürüm Yönetimi ve Kullanımdan Kaldırma
- Uç noktalar
/v1/altında yer alır ve ana sürüm içinde geriye dönük uyumludur. - Yıkıcı değişiklikler
/v2/altında yayınlanır ve/v1/en az 12 ay çalışır durumda kalır. - Yeni alan eklemek yıkıcı değildir; istemciler bilinmeyen alanları görmezden gelmelidir.
- Kullanımdan kaldırma duyuruları değişiklik günlüğünde yapılır ve hesap sahiplerine en az 90 gün önceden e-posta ile gönderilir.
Destek Kanalları
| Plan | Kanal | Yanıt Süresi |
|---|---|---|
| Free | GitHub issues, topluluk forumu | en iyi çaba |
| Starter | support@astroway.info | ≤ 1 iş günü |
| Pro | e-posta + öncelikli sıra | ≤ 4 iş saati |
| Enterprise | özel Slack / PagerDuty | sözleşmeye göre |