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

Εγγυήσεις uptime

Πρόγραμμα	Στόχος uptime	Αποζημίωση με πιστώσεις σε περίπτωση παραβίασης
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

Το uptime υπολογίζεται ανά ημερολογιακό μήνα βάσει της απάντησης από το https://api.astroway.info/v1/health με HTTP status 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

Αποποίηση ευθυνών: Οι αριθμοί είναι πραγματικοί βάσει εσωτερικής δειγματοληψίας από τον monitor api-calc, ο δημόσιος πίνακας παραγωγικής τηλεμετρίας βρίσκεται στο 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.

Πρόγραμμα	Αιτήματα / λεπτό	Μηνιαίο πιστωτικό όριο
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). Πρόσθεσέ την όταν αναφέρεις κάποιο περιστατικό — κρατάμε 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 change; οι πελάτες πρέπει να αγνοούν άγνωστα πεδία.
Η απόσυρση λειτουργικότητας ανακοινώνεται στο changelog και αποστέλλεται στους ιδιοκτήτες λογαριασμών μέσω email τουλάχιστον 90 ημέρες νωρίτερα.

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

Πρόγραμμα	Κανάλι	Απόκριση
Free	GitHub issues, κοινότητα форум	best effort
Starter	`support@astroway.info`	≤ 1 εργάσιμη ημέρα
Pro	email + προτεραιότητα ουράς	≤ 4 εργάσιμες ώρες
Enterprise	αποκλειστικό Slack / PagerDuty	σύμφωνα με σύμβαση

SLA 99.9% uptime