Uptime garanties
| Plan | Doel-Uptime | Compensatie met kredieten bij overtreding |
|---|---|---|
| Free | zonder garanties | zonder compensatie |
| Indie | 99 % | 5 % van de maandelijkse betaling per 0.1 % |
| Starter | 99.9 % | 10 % van de maandelijkse betaling per 0.1 % |
| Pro | 99.9 % | 25 % van de maandelijkse betaling per 0.1 % |
| Business | 99.95 % | 50 % van de maandelijkse betaling per 0.1 % |
| Enterprise | 99.99 % + custom | volgens contract, schriftelijke SLA |
Uptime wordt berekend per kalendermaand op basis van het antwoord https://api.astroway.info/v1/health met HTTP 200 binnen 1 000 ms. Gepland onderhoud (aangekondigd minimaal 48 uur van tevoren via statuspagina) wordt niet meegerekend.
Doelvertragingen
Gemeten op api.astroway.info/v1/* vanuit één regio, alleen de serverrekentijd (exclusief client‑ en netwerktijd). Het volledige kwartaalrapport wordt gepubliceerd op de statuspagina.
Standaard endpoints
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar‑return en soortgelijke.
| Metriek | Doel | Feitelijk (interne sampling, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Disclaimer: cijfers zijn feitelijk - interne sampling van de api‑calc monitoring, publiek production‑telemetry dashboard in de roadmap. Let op: p99 = hoogste extremen, dus de tijd is veel hoger dan p50.
Zware endpoints
Meerdagelijkse aggregaten: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metriek | Doel | Feitelijk (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1.9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1.9 s |
Rectificatie
POST /v1/rectification (tot 120 s) en POST /v1/rectification/trutine (tot 15 s) zijn per definitie langdurig en vallen niet onder de SLA‑vertragingen. Ze respecteren de header Request-Timeout tot 180 s.
Rate limiting
Zachte limiet per sleutel in rateLimitMiddleware, retourneert HTTP 429 met de header Retry-After.
| Plan | Verzoeken / minuut | Maandelijks kredietbudget |
|---|---|---|
| Free | 10 | 10 000 |
| Indie | 30 | 50 000 |
| Starter | 120 | 200 000 |
| Pro | 400 | 800 000 |
| Business | 1 000 | 3 500 000 |
| Enterprise | custom | zonder limiet |
Publieke sandbox (POST /v1/public/chart) is IP‑gelimiteerd tot 30 verzoeken per uur, zonder API‑sleutel.
Verzoekidentificatie
Elke respons bevat de header X-Request-Id (UUID). Voeg deze toe wanneer je een incident meldt – we bewaren access‑logs 30 dagen en met alleen het request‑id kunnen we je aanroep volledig reproduceren.
Bij HTTP 5xx wordt dezelfde identifier gedupliceerd in de response‑body:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Incidentrespons
| Niveau | Definitie | SLA respons |
|---|---|---|
| SEV-1 | Alle verzoeken falen / regionaal falen | bevestiging binnen 15 min |
| SEV-2 | Fout van een enkel endpoint of >5 % fouten | bevestiging binnen 1 uur |
| SEV-3 | Verslechterde vertraging (p95 > 2× doel) | dezelfde werkdag |
| SEV-4 | Cosmetisch / vraag van één klant | volgende werkdag |
Meld incidenten naar support@astroway.info met het request‑id. Voor SEV‑1 controleer ook de statuspagina.
Versiebeheer en deprecation
- Endpoints leven onder
/v1/en blijven achterwaarts compatibel binnen de hoofdversie. - Breaking changes verschijnen onder
/v2/, en/v1/blijft ≥ 12 maanden operationeel. - Toevoegen van velden wordt niet als breaking beschouwd; clients moeten onbekende velden negeren.
- Deprecation wordt aangekondigd in de changelog en per e‑mail naar account‑eigenaren verzonden minimaal 90 dagen van tevoren.
Supportkanalen
| Plan | Kanaal | Respons |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 werkdag |
| Pro | email + prioritaire wachtrij | ≤ 4 werkuren |
| Enterprise | dedicated Slack / PagerDuty | op contract |