API التصحيح: تصحيح وقت الميلاد للمطورين

معظم مستخدمي علم التنجيم يعرفون تاريخ الميلاد، لكنهم لا يعرفون الوقت الدقيق. قد يؤدي الفرق البالغ 30 دقيقة إلى تحريك الطالع (الأسيندينت) بمقدار 5 درجات أو أكثر، مما يغير مواقع البيوت والعلاقات الكوكبية. بالنسبة للعمل التنجيمي الجاد، هذا أمر مهم.

يتم تصحيح ذلك باستخدام تقنية تسمى التصحيح (Rectification) — استعادة الوقت المحتمل للولادة بناءً على أحداث الحياة المعروفة. تقليديًا، كان هذا عملاً يدويًا يستغرق ساعات. يوفر AstroWay نقطتي نهاية خوارزميتين لأتمتة هذه العملية.

في هذا المنشور، سنتناول متى يجب استخدام التصحيح، وكيف تعمل الخوارزميات، وكيفية دمجها في تطبيقك.

التصحيح هو تحسين وقت الولادة. تبدأ بوقت تقريبي (مثل “في الصباح” أو “حوالي الساعة 14:00”) ثم تضيقه باستخدام:

• أحداث الحياة الهامة (الزواج، الأطفال، تغيير المهنة، الوفيات)
• الخصائص الجسدية (ترتبط التنجيم الكلاسيكي علامة الطالع بأنواع الجسم)
• المواقع الزاويّة للكواكب عند الولادة

النتيجة هي وقت ولادة محسّن، عادةً ضمن ±5 دقائق من الوقت الفعلي.

طريقة كلاسيكية نُسبت إلى هرمس تريسمجستوس. تستخدم العلاقة بين موقع القمر عند الولادة والطالع/النقيض (الديزيندينت) عند لحظة الحمل (قبل حوالي 9 أشهر).

كيف يعمل:

1. نأخذ التاريخ التقريبي للولادة
2. نحسب نطاق تواريخ الحمل (260–290 يومًا سابقًا)
3. لكل تاريخ مرشح للحمل، نتحقق مما إذا كان موقع القمر عند الولادة يتطابق مع الطالع/النقيض في لحظة الحمل
4. نعيد قائمة بالأوقات المرشحة للولادة، مرتبة حسب مدى التطابق

سريع، لكن أقل دقة. جيد لتضييق نافذة واسعة (مثل “في الصباح” → نافذة ساعتين).

const result = await client.rectificationTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`Best candidate: ${result.bestTime}`);
console.log(`Confidence: ${result.confidence}`);

نهج خوارزمي يعتمد على عدة أحداث حياة. هذا الخيار الأثقل (حتى 120 ثانية لكل طلب).

المدخلات:

• وقت ولادة تقريبي (نطاق)
• قائمة أحداث الحياة مع التواريخ والأنواع
• اختياريًا: وصف جسدي

الخوارزمية:

1. توليد أوقات ولادة مرشحة داخل النطاق (عادةً بخطوة دقيقة واحدة)
2. لكل مرشح، حساب الخريطة Natal
3. تقييم مدى تطابق الأحداث مع الأنماط التنجيمية المتوقعة (التقدمات، التوجيهات، الترانزيت)
4. إعادة أفضل المرشحين مع درجات الثقة

const result = await client.rectification({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '18:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
  events: [
    { date: '2015-06-20', type: 'marriage' },
    { date: '2018-03-12', type: 'firstChild' },
    { date: '2020-09-05', type: 'careerChange' },
  ],
});

console.log(`Rectified time: ${result.bestTime}`);
console.log(`Candidates: ${result.candidates.length}`);

التصحيح قيم لـ:

• التطبيقات ذات المستخدمين الذين لا يعرفون الوقت — اعرض التصحيح كميزةPremium
• أدوات التنجيم الاحترافية — يوفر ساعات من العمل اليدوي لكل عميل
• التطبيقات عالية الدقة — حساسة للغاية للوقت؛ يحسن التصحيح الدقة بشكل كبير
• التطبيقات البحثية — للتحقق من الخرائط التاريخية حيث تكون سجلات الوقت غير دقيقة

غير مفيد لـ:

• التطبيقات التي يعرف فيها المستخدم الوقت بدقة ±5 دقائق (لا فائدة)
• تطبيقات الأبراج اليومية حيث لا يؤثر وقت الميلاد على النتيجة (علامة الشمس اليومية لا تحتاجها)

• تراوتين: 250 رصيدًا — ~1–2 ثانية لكل طلب
• التصحيح الكامل: 500 رصيدًا — حتى 120 ثانية

هذه هي نقاط النهاية الأكثر تكلفة في واجهة برمجة التطبيقات. إذا عرضت التصحيح كإحدى الميزات، فتأكد من تسعيرها بشكل مناسب: إنها عمليةPremium تبرر سعر اشتراك أعلى أو شراء لمرة واحدة.

تخطيط الميزانية:

• 100 تصحيح شهريًا: ~50,000 رصيدًا = خطة Pro ($59) مع هامش للطلبات الأخرى
• 1,000 تصحيح شهريًا: 500,000 رصيدًا = خطة Enterprise

التصحيح يستغرق وقتًا. يجب أن يتضمن واجهة المستخدم:

• معالجة غير متزامنة — لا توقف الطلب؛ ضعها في قائمة انتظار، وأظهر التقدم
• مؤشر التقدم — قد يستغرق نقطة النهاية الكاملة حتى 120 ثانية؛ يحتاج المستخدم إلى تحديث
• عرض النتائج — الوقت المحسّن، مستوى الثقة، إمكانية إعادة التشغيل إذا كانت الأحداث غير دقيقة

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('جارٍ التصحيح (قد يستغرق حتى دقيقتين)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`تمت العملية. الوقت المحسّن: ${result.bestTime} (ثقة: ${result.confidence}%)`);
  } catch (err) {
    setStatus(`خطأ: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

العملية النموذجية للتصحيح في تطبيقك:

1. يدخل المستخدم البيانات التقريبية للولادة + أحداث الحياة
2. يستدعي التطبيق أولاً /v1/rectification/trutine (رخيص وسريع) لتضييق النطاق
3. ثم يستدعي /v1/rectification (الكامل) بالنطاق الدقيق للحصول على الدقة
4. يخزن التطبيق النتيجة ويستخدم الوقت المحسّن لجميع الحسابات المستقبلية
5. تُوضع علامة على الطلبات المستقبلية بمؤشر “rectified from approximate”

هذا النهج المشترك يكلف ~750 رصيدًا للدورة الكاملة، لكنه يوفر أفضل دقة.

التصحيح لا يعطي دقة 100% أبدًا. حتى التنجيميون المحترفون يختلفون في تقديراتهم بمقدار 5–10 دقائق.

خوارزمية AstroWay موجهة نحو الدقة النسبية — تضيق النطاق، لكن المخرجات تُعرض دائمًا على أنها “أفضل مرشح” وليس حقيقة مطلقة. دائمًا ما تظهر للمستخدمين درجة الثقة، وامنحهم خيار إعادة التقييم إذا كانت لديهم معلومات أفضل.

الخوارزميات عبارة عن بحث عن أنماط. يأخذ التنجيمي الخبير في الاعتبار السياق الذي يصعب ترميزه: “هل كان الزواج متسرعًا؟” “هل كان تغيير المهنة طوعيًا؟” للخرائط ذات المخاطر العالية، جرب:

1. التصحيح الخوارزمي — لتضييق النطاق
2. المراجعة اليدوية من قبل خبير التنجيم — للتحديد النهائي

يمكن لتطبيقك تقديم هذا كاستشارةPremium.

• مرجع واجهة برمجة التطبيقات — ابحث عن نقاط النهاية rectification وrectification/trutine
• الأسعار — تكلفة الرصيد حسب الخطة
• البدء السريع — احصل على مفتاح API