Accord de niveau de service (SLA)

Garanties de disponibilité

Plan	Disponibilité cible	Compensation en crédits en cas de violation
Free	sans garantie	sans compensation
Indie	99 %	5 % du paiement mensuel par chaque 0.1 %
Starter	99.9 %	10 % du paiement mensuel par chaque 0.1 %
Pro	99.9 %	25 % du paiement mensuel par chaque 0.1 %
Business	99.95 %	50 % du paiement mensuel par chaque 0.1 %
Enterprise	99.99 % + custom	selon contrat, SLA écrit

Le temps de disponibilité est calculé sur un mois calendaire à partir de la réponse https://api.astroway.info/v1/health avec le statut HTTP 200 pendant 1 000 ms. Les travaux planifiés (annoncés au moins 48 h à l’avance via la page de statut) ne sont pas inclus dans le calcul.

Délais cibles

Mesurés sur api.astroway.info/v1/* depuis une seule région, uniquement le temps de calcul serveur (sans prendre en compte le client et le réseau). Le rapport trimestriel complet est publié sur la page de statut.

Endpoints standards

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return et similaires.

Métrique	Cible	Réel (échantillonnage interne, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Disclaimer: les nombres sont réels - échantillonnage interne depuis la surveillance api-calc, tableau de bord de télémétrie de production public dans la roadmap. Note : p99 = extrêmes les plus élevés, donc le temps est bien plus élevé que p50.

Endpoints lourds

Agrégats multi-jours : transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Métrique	Cible	Réel (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Rectification

POST /v1/rectification (jusqu’à 120 s) et POST /v1/rectification/trutine (jusqu’à 15 s) sont par nature longs et ne relèvent pas du SLA de délais. Ils respectent l’en‑tête Request-Timeout jusqu’à 180 s.

Limitation de fréquence

Limite souple par clé dans rateLimitMiddleware, renvoie HTTP 429 avec l’en‑tête Retry-After.

Plan	Requêtes / minute	Budget mensuel de crédits
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	sans limite

Le sandbox public (POST /v1/public/chart) est limité par IP - 30 requêtes / heure, sans clé API.

Identification de la requête

Chaque réponse contient l’en‑tête X-Request-Id (UUID). Ajoute‑le quand tu signales un incident - nous conservons les logs d’accès 30 jours et avec seulement le request-id nous pouvons reproduire entièrement ton appel.

Sur HTTP 5xx le même identifiant est dupliqué dans le corps de la réponse:

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

Réaction aux incidents

Niveau	Définition	SLA de réponse
SEV-1	Toutes les requêtes échouent / panne régionale	confirmation sous 15 min
SEV-2	Panne d’un endpoint ou >5 % d’erreurs	confirmation sous 1 h
SEV-3	Retard dégradé (p95 > 2× les cibles)	le même jour ouvrable
SEV-4	Cosmétique / question d’un seul client	le jour ouvrable suivant

Signale les incidents à support@astroway.info avec le request-id. Pour les SEV-1, vérifie également la page de statut.

Versionnage et dépréciation

Les endpoints vivent sous /v1/ et restent rétrocompatibles au sein de la version principale.
Les breaking changes arrivent sous /v2/, et /v1/ continue de fonctionner ≥ 12 mois.
L’ajout de champs n’est pas considéré comme breaking ; les clients doivent ignorer les champs inconnus.
La dépréciation est annoncée dans le changelog et envoyée aux propriétaires de comptes par email au moins 90 jours à l’avance.

Canaux de support

Plan	Canal	Réponse
Free	GitHub issues, community forum	best effort
Starter	`support@astroway.info`	≤ 1 jour ouvrable
Pro	email + file d’attente prioritaire	≤ 4 heures ouvrables
Enterprise	Slack dédié / PagerDuty	selon contrat

SLA 99.9% uptime