Thỏa thuận mức dịch vụ (SLA)

Bảo đảm thời gian hoạt động

Kế hoạch	Thời gian hoạt động mục tiêu	Bồi hoàn bằng kredit khi vi phạm
Free	không có bảo đảm	không bồi hoàn
Indie	99 %	5% phí hàng tháng cho mỗi 0.1 %
Starter	99.9 %	10% phí hàng tháng cho mỗi 0.1 %
Pro	99.9 %	25% phí hàng tháng cho mỗi 0.1 %
Business	99.95 %	50% phí hàng tháng cho mỗi 0.1 %
Enterprise	99.99 % + custom	theo hợp đồng, SLA bằng văn bản

Thời gian hoạt động được tính theo tháng lịch dựa trên phản hồi https://api.astroway.info/v1/health với trạng thái HTTP 200 trong vòng 1 000 ms. Công việc bảo trì (được thông báo ít nhất 48 giờ trước qua trang trạng thái) không được tính vào thời gian hoạt động.

Độ trễ mục tiêu

Được đo trên api.astroway.info/v1/* từ một khu vực, chỉ thời gian xử lý phía máy chủ (không tính thời gian client và mạng). Báo cáo quý đầy đủ được công bố trên trang trạng thái.

Các endpoint tiêu chuẩn

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return và các tương tự.

Metric	Mục tiêu	Thực tế (sampling nội bộ, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Disclaimer: các số thực tế - sampling nội bộ từ giám sát api-calc, bảng điều khiển production-telemetry công khai trong roadmap. Lưu ý: p99 = mức cực đại, vì vậy thời gian cao hơn đáng kể so với p50.

Các endpoint nặng

Các tập hợp đa ngày: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Metric	Mục tiêu	Thực tế (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Rectification

POST /v1/rectification (tối đa 120 s) và POST /v1/rectification/trutine (tối đa 15 s) theo bản chất là các yêu cầu dài và không nằm trong SLA độ trễ. Chúng tôn trọng header Request-Timeout lên tới 180 s.

Giới hạn tần suất

Giới hạn mềm cho key trong rateLimitMiddleware, trả về HTTP 429 với header Retry-After.

Kế hoạch	Yêu cầu / phút	Ngân sách kredit hàng tháng
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	không giới hạn

Sandbox công cộng (POST /v1/public/chart) bị giới hạn theo IP - 30 yêu cầu / giờ, không cần API-key.

Nhận dạng yêu cầu

Mỗi phản hồi chứa header X-Request-Id (UUID). Thêm nó khi báo cáo sự cố - chúng tôi lưu log truy cập 30 ngày và chỉ với request-id có thể tái tạo đầy đủ lời gọi của bạn.

Trong HTTP 5xx cùng một identifier được lặp lại trong body phản hồi:

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

Phản hồi sự cố

Mức độ	Định nghĩa	SLA phản hồi
SEV-1	Tất cả yêu cầu bị sập / sự cố khu vực	xác nhận trong 15 phút
SEV-2	Sự cố endpoint riêng lẻ hoặc >5% lỗi	xác nhận trong 1 giờ
SEV-3	Độ trễ suy giảm (p95 > 2× mục tiêu)	cùng ngày làm việc
SEV-4	Vấn đề thẩm mỹ / câu hỏi của một khách hàng	ngày làm việc tiếp theo

Báo cáo sự cố tới support@astroway.info kèm request-id. Đối với SEV-1 cũng kiểm tra trang trạng thái.

Phiên bản và deprecation

Các endpoint nằm dưới /v1/ và vẫn tương thích ngược trong cùng phiên bản chính.
Breaking changes sẽ xuất hiện dưới /v2/, và /v1/ sẽ tiếp tục hoạt động ≥ 12 tháng.
Thêm trường không được coi là breaking; khách hàng nên bỏ qua các trường không biết.
Deprecation được công bố trong changelog và gửi tới chủ tài khoản qua email ít nhất 90 ngày trước.

Kênh hỗ trợ

Kế hoạch	Kênh	Phản hồi
Free	GitHub issues, community forum	best effort
Starter	`support@astroway.info`	≤ 1 ngày làm việc
Pro	email + hàng ưu tiên	≤ 4 giờ làm việc
Enterprise	Slack / PagerDuty riêng	theo hợp đồng

SLA 99.9% uptime