ضمانات وقت التشغيل
| الخطة | وقت التشغيل المستهدف | تعويض بالائتمانات عند الانتهاك |
|---|---|---|
| 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/* من منطقة واحدة، فقط وقت معالجة الخادم (بدون احتساب العميل والشبكة). ننشر التقرير الربعي الكامل على صفحة الحالة.
نقاط النهاية القياسية
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return وغيرها.
| المقياس | الهدف | فعليًا (العينة الداخلية، 2026-05-09) |
|---|---|---|
| p50 | < 100 مللي ثانية | ~80 مللي ثانية |
| p95 | < 500 مللي ثانية | ~280 مللي ثانية |
| p99 | < 1 ثانية | ~640 مللي ثانية |
إخلاء مسؤولية: الأرقام فعلية - عينة داخلية من مراقبة api-calc، لوحة تحكم الإنتاج العامة في خارطة الطريق. لاحظ أن: p99 = أعلى القيم المتطرفة، لذا الوقت أعلى بكثير من p50.
نقاط النهاية الثقيلة
مجموعات متعددة الأيام: transit-calendar، forecast-calendar، moon-aspects، aspect-timeline، group-synastry، eclipse-analysis.
| المقياس | الهدف | فعليًا (2026-04-15) |
|---|---|---|
| p95 | < 2 ثانية | 1.9 ثانية (moon-aspects، 30 يوم) |
| p99 | < 4 ثانية | 1.9 ثانية |
التصحيح
POST /v1/rectification (حتى 120 ثانية) و POST /v1/rectification/trutine (حتى 15 ثانية) بطبيعتها طويلة الأمد ولا تخضع لحدود SLA للتأخير. إنها تحترم رأس Request-Timeout حتى 180 ثانية.
حدود المعدل
حد ناعم للمفتاح في 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 | بدون حد |
صندوق الرمل العام (POST /v1/public/chart) مقيد حسب IP - 30 طلبًا / ساعة، بدون مفتاح API.
تعريف الطلب
كل استجابة تحتوي على رأس X-Request-Id (UUID). أضفه عندما تبلغ عن حادثة - نحن نحتفظ بسجلات الوصول 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 | عطل نقطة نهاية واحدة أو >5٪ أخطاء | تأكيد خلال 1 ساعة |
| SEV-3 | تأخير متدهور (p95 > 2× الأهداف) | في نفس يوم العمل |
| SEV-4 | تجميلية / سؤال عميل واحد | في يوم العمل التالي |
أبلغ عن الحوادث إلى support@astroway.info مع request-id. بالنسبة لـ SEV-1 تحقق أيضًا من صفحة الحالة.
الإصدارات وإلغاء الدعم
- نقاط النهاية موجودة تحت
/v1/وتبقى متوافقة عكسيًا ضمن النسخة الرئيسية. - التغييرات الجذرية تُصدر تحت
/v2/، بينما يظل/v1/يعمل ≥ 12 شهرًا. - إضافة حقول لا تُعتبر breaking؛ يجب على العملاء تجاهل الحقول غير المعروفة.
- إلغاء الدعم يُعلن في changelog ويُرسل إلى مالكي الحسابات عبر البريد الإلكتروني قبل 90 يومًا على الأقل.
قنوات الدعم
| الخطة | القناة | الرد |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 يوم عمل |
| Pro | email + пріоритетна черга | ≤ 4 ساعات عمل |
| Enterprise | виділений Slack / PagerDuty | حسب العقد |