Perjanjian Tingkat Layanan (SLA)

Jaminan Waktu Aktif

Paket	Target Waktu Aktif	Kompensasi Kredit Saat Pelanggaran
Free	tanpa jaminan	tanpa kompensasi
Indie	99 %	5 % pembayaran bulanan untuk setiap 0.1 %
Starter	99.9 %	10 % pembayaran bulanan untuk setiap 0.1 %
Pro	99.9 %	25 % pembayaran bulanan untuk setiap 0.1 %
Business	99.95 %	50 % pembayaran bulanan untuk setiap 0.1 %
Enterprise	99.99 % + custom	berdasarkan kontrak, SLA tertulis

Waktu aktif dihitung per bulan kalender berdasarkan respons dari https://api.astroway.info/v1/health dengan status HTTP 200 dalam waktu 1.000 milidetik. Pemeliharaan terjadwal (diumumkan setidaknya 48 jam sebelumnya melalui halaman status) tidak termasuk dalam perhitungan.

Target Waktu Tanggapan

Diukur pada api.astroway.info/v1/* dari satu wilayah, hanya waktu pemrosesan server (tanpa memperhitungkan klien dan jaringan). Laporan triwulanan lengkap dipublikasikan di halaman status.

Endpoint Standar

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

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

Penafian: Angka aktual adalah sampling internal dari pemantauan api-calc, dashboard telemetri produksi publik masih dalam roadmap. Perhatikan: p99 = nilai ekstrem tertinggi, sehingga waktunya jauh lebih tinggi daripada 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

Rektifikasi

POST /v1/rectification (hingga 120 detik) dan POST /v1/rectification/trutine (hingga 15 detik) bersifat jangka panjang secara alami dan tidak tunduk pada SLA waktu tanggapan. Mereka menghormati header Request-Timeout hingga 180 detik.

Pembatasan Laju

Pembatasan lunak pada kunci di rateLimitMiddleware, mengembalikan HTTP 429 dengan header Retry-After.

Paket	Permintaan / menit	Anggaran 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 kunci API.

Identifikasi Permintaan

Setiap respons berisi header X-Request-Id (UUID). Gunakan header ini saat melaporkan insiden — kami menyimpan access-log selama 30 hari dan dengan request-id saja kami dapat sepenuhnya merekonstruksi panggilanmu.

Pada HTTP 5xx, pengenal yang sama juga diduplikasi dalam badan respons:

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

Respons Insiden

Tingkat	Definisi	SLA Tanggapan
SEV-1	Semua permintaan gagal / kegagalan regional	konfirmasi dalam 15 menit
SEV-2	Kegagalan endpoint tertentu atau >5 % error	konfirmasi dalam 1 jam
SEV-3	Keterlambatan terdegradasi (p95 > 2× target)	hari kerja yang sama
SEV-4	Masalah kosmetik / satu klien	hari kerja berikutnya

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

Versi dan Deprecation

Endpoint berada di bawah /v1/ dan tetap backward compatible dalam satu versi utama.
Perubahan breaking akan dirilis di bawah /v2/, sementara /v1/ akan tetap beroperasi ≥ 12 bulan.
Penambahan field bukanlah perubahan breaking; klien harus mengabaikan field yang tidak dikenal.
Deprecation diumumkan di changelog dan dikirim ke pemilik akun melalui email setidaknya 90 hari sebelumnya.

Saluran Dukungan

Paket	Saluran	Tanggapan
Free	GitHub issues, forum komunitas	best effort
Starter	`support@astroway.info`	≤ 1 hari kerja
Pro	email + antrian prioritas	≤ 4 jam kerja
Enterprise	Slack / PagerDuty khusus	berdasarkan kontrak

SLA 99.9% uptime