SLA 99.9% uptime

Cam kết về thời gian hoạt động

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

Mục tiêu độ trễ

Được đo trên api.astroway.info/v1/* từ cùng một khu vực, chỉ tính thời gian xử lý trên máy chủ (không bao gồm thời gian mạng hay phía client). Báo cáo đầy đủ theo quý đượ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à những endpoint tương tự.

Lưu ý: Các con số thực tế là kết quả lấy mẫu nội bộ từ hệ thống giám sát api-calc, bảng điều khiển giám sát production công khai vẫn đang trong kế hoạch. Lưu ý: p99 = giá trị cực trị cao nhất, do đó thời gian sẽ cao hơn nhiều so với p50.

Các endpoint nặng

Tổng hợp dữ liệu đa ngày: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Hiệu chỉnh

POST /v1/rectification (tối đa 120 s) và POST /v1/rectification/trutine (tối đa 15 s) vốn dĩ là những tác vụ dài hạn và không nằm trong cam kết SLA về độ trễ. Chúng tuân thủ tiêu đề Request-Timeout lên đến 180 s.

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

Giới hạn mềm trên mỗi khóa trong rateLimitMiddleware, trả về HTTP 429 kèm theo tiêu đề Retry-After.

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

Định danh yêu cầu

Mỗi phản hồi đều chứa tiêu đề X-Request-Id (UUID). Hãy cung cấp ID này khi báo cáo sự cố — chúng tôi lưu trữ access-log trong 30 ngày và có thể tái hiện toàn bộ yêu cầu của bạn chỉ bằng request-id.

Trên HTTP 5xx, cùng định danh này cũng được nhân đôi trong phần thân phản hồi:

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

Phản ứng với sự cố

Hãy báo cáo sự cố tới support@astroway.info kèm theo request-id. Đối với SEV-1, hãy kiểm tra trang trạng thái.

Quản lý phiên bản và ngừng hỗ trợ

• Các endpoint hoạt động dưới /v1/ và duy trì khả năng tương thích ngược trong cùng phiên bản chính.
• Các thay đổi phá vỡ (breaking changes) sẽ ra mắt dưới /v2/, còn /v1/ sẽ tiếp tục hoạt động ≥ 12 tháng.
• Việc bổ sung trường không được coi là thay đổi phá vỡ; khách hàng cần bỏ qua các trường không xác định.
• Thông báo ngừng hỗ trợ được đăng trên changelog và gửi tới chủ sở hữu tài khoản qua email ít nhất 90 ngày trước.

Kênh hỗ trợ