Συμφωνία επιπέδου υπηρεσίας (SLA)

Εγγυήσεις διαθεσιμότητας

Σχέδιο	Στόχος διαθεσιμότητας	Αποζημίωση με credits σε περίπτωση παραβίασης
Free	χωρίς εγγύηση	χωρίς αποζημίωση
Indie	99 %	5 % μηνιαίας πληρωμής ανά 0.1 %
Starter	99.9 %	10 % μηνιαίας πληρωμής ανά 0.1 %
Pro	99.9 %	25 % μηνιαίας πληρωμής ανά 0.1 %
Business	99.95 %	50 % μηνιαίας πληρωμής ανά 0.1 %
Enterprise	99.99 % + custom	σύμφωνα με σύμβαση, γραπτό SLA

Η διαθεσιμότητα υπολογίζεται ανά ημερολογιακό μήνα με βάση την απάντηση https://api.astroway.info/v1/health με κατάσταση HTTP 200 εντός 1 000 ms. Οι προγραμματισμένες εργασίες (ανακοινώνουμε τουλάχιστον 48 ώρες νωρίτερα μέσω σελίδας κατάστασης) δεν υπολογίζονται.

Στόχοι καθυστέρησης

Μετρώνται στο api.astroway.info/v1/* από μία περιοχή, μόνο ο χρόνος επεξεργασίας του διακομιστή (χωρίς να ληφθεί υπόψη ο πελάτης και το δίκτυο). Ο πλήρης τριμηνιαίος αναφορά δημοσιεύεται στη σελίδα κατάστασης.

Τυπικά endpoints

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return και παρόμοια.

Μετρική	Στόχος	Πραγματικό (εσωτερική δειγματοληψία, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Disclaimer: οι αριθμοί είναι πραγματικοί - εσωτερική δειγματοληψία από την παρακολούθηση api-calc, δημόσιο production-telemetry dashboard στο roadmap. Σημείωση: p99 = highest extremes, γι’ αυτό ο χρόνος είναι πολύ μεγαλύτερος από το p50.

Βαρύτερα endpoints

Αγροί πολλών ημερών: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Μετρική	Στόχος	Πραγματικό (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Διόρθωση

POST /v1/rectification (μέχρι 120 s) και POST /v1/rectification/trutine (μέχρι 15 s) από τη φύση τους είναι μακροχρόνια και δεν εμπίπτουν στο SLA καθυστέρησης. Τηρούν την κεφαλίδα Request-Timeout έως 180 s.

Περιορισμός ρυθμού

Μαλακός περιορισμός ανά κλειδί στο rateLimitMiddleware, επιστρέφει HTTP 429 με την κεφαλίδα Retry-After.

Σχέδιο	Αιτήματα / λεπτό	Μηνιαίο προϋπολογισμό credits
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	χωρίς όριο

Το δημόσιο sandbox (POST /v1/public/chart) περιορίζεται ανά IP - 30 αιτήματα / ώρα, χωρίς API-κλειδί.

Ταυτοποίηση αιτήματος

Κάθε απάντηση περιέχει την κεφαλίδα X-Request-Id (UUID). Πρόσθεσέ την όταν αναφέρεις ένα περιστατικό - διατηρούμε τα access-logs 30 ημέρες και μόνο με το request-id μπορούμε να αναδημιουργήσουμε πλήρως την κλήση σου.

Σε HTTP 5xx το ίδιο αναγνωριστικό επαναλαμβάνεται στο σώμα της απάντησης:

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

Αντιμετώπιση περιστατικών

Επίπεδο	Ορισμός	SLA απάντησης
SEV-1	Όλα τα αιτήματα πέφτουν / περιφερειακό σφάλμα	επιβεβαίωση εντός 15 λεπτών
SEV-2	Σφάλμα μεμονωμένου endpoint ή >5 % σφαλμάτων	επιβεβαίωση εντός 1 ώρας
SEV-3	Κατεστραμμένη καθυστέρηση (p95 > 2× στόχοι)	την ίδια εργάσιμη ημέρα
SEV-4	Καλλωπιστικό / ερώτημα ενός πελάτη	την επόμενη εργάσιμη ημέρα

Αναφέρετε περιστατικά στο support@astroway.info με το request-id. Για SEV-1 ελέγξτε επίσης τη σελίδα κατάστασης.

Έκδοση και αποσυμφόρηση

Τα endpoints βρίσκονται κάτω από /v1/ και παραμένουν συμβατά προς τα πίσω εντός της κύριας έκδοσης.
Breaking changes κυκλοφορούν κάτω από /v2/, ενώ το /v1/ συνεχίζει να λειτουργεί ≥ 12 μήνες.
Η προσθήκη πεδίων δεν θεωρείται breaking· οι πελάτες πρέπει να αγνοούν τα άγνωστα πεδία.
Η αποσυμφόρηση ανακοινώνεται στο changelog και αποστέλλεται στους ιδιοκτήτες λογαριασμών μέσω email τουλάχιστον 90 ημέρες νωρίτερα.

Κανάλια υποστήριξης

Σχέδιο	Κανάλι	Απάντηση
Free	GitHub issues, community forum	best effort
Starter	`support@astroway.info`	≤ 1 εργάσιμη ημέρα
Pro	email + προτεραιότητα σειρά	≤ 4 εργάσιμες ώρες
Enterprise	dedicated Slack / PagerDuty	σύμφωνα με σύμβαση

SLA 99.9% uptime