Perjanjian Tingkat Layanan (SLA)

Garansi Uptime

Plan	Target Uptime	Kompensasi kredit saat pelanggaran
Free	tanpa garansi	tanpa kompensasi
Indie	99 %	5 % pembayaran bulanan per 0.1 %
Starter	99.9 %	10 % pembayaran bulanan per 0.1 %
Pro	99.9 %	25 % pembayaran bulanan per 0.1 %
Business	99.95 %	50 % pembayaran bulanan per 0.1 %
Enterprise	99.99 % + custom	sesuai kontrak, SLA tertulis

Uptime dihitung per bulan kalender berdasarkan respons https://api.astroway.info/v1/health dengan status HTTP 200 dalam 1.000 ms. Pemeliharaan terjadwal (diumumkan minimal 48 jam melalui halaman status) tidak dihitung dalam perhitungan.

Target Latensi

Diukur pada api.astroway.info/v1/* dari satu wilayah, hanya waktu perhitungan di sisi server (tidak termasuk klien dan jaringan). Laporan kuartal lengkap dipublikasikan di halaman status.

Endpoint Standar

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return dan serupa.

Metrik	Target	Aktual (sampling internal, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Disclaimer: angka aktual - sampling internal dari monitoring api-calc, public production-telemetry dashboard dalam roadmap. Perhatikan: p99 = ekstrem tertinggi, jadi waktu jauh lebih tinggi dari p50.

Endpoint Berat

Agregasi multi-hari: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Metrik	Target	Aktual (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Rectifikasi

POST /v1/rectification (sampai 120 s) dan POST /v1/rectification/trutine (sampai 15 s) secara inheren berjalan lama dan tidak tunduk pada SLA latensi. Mereka menghormati header Request-Timeout hingga 180 s.

Rate Limit

Batas lunak per key di rateLimitMiddleware, mengembalikan HTTP 429 dengan header Retry-After.

Plan	Permintaan / menit	Budget kredit bulanan
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	tanpa batas

Sandbox publik (POST /v1/public/chart) dibatasi per IP - 30 permintaan / jam, tanpa API key.

Identifikasi Permintaan

Setiap respons berisi header X-Request-Id (UUID). Tambahkan saat melaporkan insiden - kami menyimpan access log selama 30 hari dan dengan satu request-id saja kami dapat mereproduksi sepenuhnya panggilan kamu.

Pada HTTP 5xx, identik yang sama duplikasi di body respons:

{
  "ok": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f"
  }
}

Respons Terhadap Insiden

Level	Definisi	SLA respons
SEV-1	Semua permintaan gagal / kerusakan regional	konfirmasi dalam 15 menit
SEV-2	Kegagalan endpoint individual atau >5% error	konfirmasi dalam 1 jam
SEV-3	Latensi terdegradasi (p95 > 2× target)	hari kerja yang sama
SEV-4	Kosmetik / masalah satu klien	hari kerja berikutnya

Laporkan insiden ke support@astroway.info dengan request-id. Untuk SEV-1 juga periksa halaman status.

Versi dan Depresiasi

Endpoint berada di bawah /v1/ dan tetap kompatibel mundu dalam versi utama.
Perubahan breaking dirilis di bawah /v2/, dan /v1/ terus berjalan ≥ 12 bulan.
Penambahan field tidak dianggap breaking; klien harus mengabaikan field yang tidak dikenal.
Depresiasi diumumkan di changelog dan dikirim ke pemilik akun via email minimal 90 hari sebelumnya.

Saluran Dukungan

Plan	Salur	Respons
Free	GitHub issues, community forum	best effort
Starter	`support@astroway.info`	≤ 1 hari kerja
Pro	email + antrian prioritas	≤ 4 jam kerja
Enterprise	Slack / PagerDuty khusus	sesuai kontrak

SLA 99.9% uptime