Accord de niveau de service (SLA)

Garanties de disponibilité

Plan	Disponibilité cible	Compensation en crédits en cas de manquement
Free	sans garantie	sans compensation
Indie	99 %	5 % du paiement mensuel pour chaque 0,1 %
Starter	99,9 %	10 % du paiement mensuel pour chaque 0,1 %
Pro	99,9 %	25 % du paiement mensuel pour chaque 0,1 %
Business	99,95 %	50 % du paiement mensuel pour chaque 0,1 %
Enterprise	99,99 % + custom	selon contrat, SLA écrit

La disponibilité est calculée sur un mois civil en fonction des réponses de https://api.astroway.info/v1/health avec un statut HTTP 200 en moins de 1 000 ms. Les travaux planifiés (annoncés au moins 48 h à l’avance via la page de statut) ne sont pas pris en compte dans le calcul.

Latences cibles

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

Endpoints standard

Chart, planets, synastry, transits, progressions, ACG, géodésique, 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

Avertissement : Les chiffres réels proviennent d’un échantillonnage interne via le monitoring api-calc. Le tableau de bord de télémétrie publique est en cours de développement. Note : p99 = valeurs extrêmes les plus élevées, donc le temps est bien plus élevé que p50.

Endpoints lourds

Agrégations sur plusieurs 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, 30j)
p99	< 4 s	1,9 s

Rectification

POST /v1/rectification (jusqu’à 120 s) et POST /v1/rectification/trutine (jusqu’à 15 s) sont par nature des opérations longues et ne sont pas soumis aux SLA de latence. Ils respectent l’en-tête Request-Timeout jusqu’à 180 s.

Limites de débit

Limite douce sur la clé dans rateLimitMiddleware, retourne 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 des requêtes

Chaque réponse inclut l’en-tête X-Request-Id (UUID). Ajoute-le lorsque tu signales un incident — nous conservons les logs d’accès pendant 30 jours et pouvons reconstruire entièrement ton appel à partir d’un seul request-id.

En cas d’erreur 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"
  }
}

Gestion des incidents

Niveau	Définition	SLA de réponse
SEV-1	Tous les endpoints échouent / panne régionale	confirmation sous 15 min
SEV-2	Échec d’un endpoint ou >5 % d’erreurs	confirmation sous 1 h
SEV-3	Latence dégradée (p95 > 2× la cible)	avant la fin de la journée de travail
SEV-4	Problème cosmétique / question d’un seul client	avant la fin du jour ouvré suivant

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

Versioning et dépréciation

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

Canaux de support

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

SLA 99.9% uptime