AstroWay/api v2.102.11 · ar
جميع الأنظمة تعمل بشكل طبيعي

API التصميم البشري: بناء تطبيقات HD على 12 نقطة نهاية

كل ما يحتاجه المطور لإنشاء تطبيق التصميم البشري عبر API. 12 نقطة نهاية، حساب الجسم، ديناميكية المجموعة مع Penta، أمثلة على الكود.

🕓 تدوينة بتاريخ 2026-04-14، آخر تحديث 2026-05-09. أصبحت مكتبات تطوير TS / Python / PHP (@astroway/sdk على npm، astroway على PyPI، astroway/sdk على Packagist) متاحة الآن في السجلات العامة. للمزيد، راجع سجل التغييرات.

انتقل التصميم البشري (Human Design) من نظام طائفي نيشئي في التسعينيات إلى إطار عمل سائد في التنمية الشخصية. أصبحت التطبيقات التي تضم ملايين المستخدمين طبيعية بالنسبة له، وأصبح المطورون يتساءلون: كيف يمكن حساب خريطة التصميم البشري برمجياً؟

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

ما هو التصميم البشري من الناحية التقنية؟

Section titled “ما هو التصميم البشري من الناحية التقنية؟”

يعتمد التصميم البشري على ثلاث أنظمة كلاسيكية:

  • علم التنجيم الغربي — مواضع الكواكب في وقت الولادة
  • آي تشينغ (I Ching) — 64 هكساغرام، تم تعيينها إلى 64 «بوابات»
  • نظام الشاكرات — تسعة «مراكز» (عقد طاقة)

يحسب التصميم البيانات من وقت الولادة ويصدر رسم الجسم (bodygraph) — خريطة بصرية تحتوي على:

  • النوع (Manifestor، Generator، Manifesting Generator، Projector، Reflector) — البصمة الطاقوية
  • الاستراتيجية — كيفية اتخاذ القرارات
  • السلطة — أي مركز يجب الاعتماد عليه عند اتخاذ القرارات (Sacral، Emotional، Splenic، إلخ)
  • الملف الشخصي (Profile) — مزيج من الخطوط (مثل 1/3، 4/6، إلخ)
  • القنوات (Channels) — الروابط بين المراكز التي تشكل الشخصية
  • الصليب incarnation (Incarnation Cross) — الغرض من الحياة، المشتق من أربع نقاط رئيسية

تحت الغطاء، كل من الـ 64 بوابة соответствует نطاقاً من خط الطول الاستوائي. يتم تعيين خط طول كواكبك عند الولادة إلى بوابات محددة (وسطور داخلها). حساب «التصميم» (Design) هو إزاحة الشمس بمقدار 88 درجة قبل وقت الولادة — أي قبل حوالي 3 أشهر.

خريطتان: الشخصية والتصميم

Section titled “خريطتان: الشخصية والتصميم”

يستخدم التصميم البشري نقطتي ولادة:

  1. الشخصية (Personality) — الوقت الفعلي للولادة. هذا هو الجانب «الواع».
  2. التصميم (Design) — عندما كانت الشمس في الموقع الذي ستكون عليه قبل 88 درجة من وقت الولادة. هذا هو الجانب «غير الواعي».

تنشط كل بوابة إلى واحدة من هاتين الخريطتين. تحتوي الخريطة الكاملة على 13 + 13 = 26 تنشيطاً.

هذا ما يجعل حساب التصميم البشري أكثر تعقيداً من خريطة التنجيم القياسية — فأنت تحسب في الواقع خريطتين.

واجهات برمجة التطبيقات (APIs) التي تدعم التصميم البشري

Section titled “واجهات برمجة التطبيقات (APIs) التي تدعم التصميم البشري”

معظم واجهات برمجة التطبيقات (APIs) في مجال التنجيم إما لا تدعم التصميم البشري على الإطلاق أو تقدم دعمًا سطحيًا (مثل النوع + الاستراتيجية فقط). يتطلب التنفيذ الكامل للتصميم البشري:

  • جدول بحث للـ 64 بوابة
  • 6 خطوط لكل بوابة (384 خلية)
  • 9 مراكز مع منطق defined/open
  • 36 قناة (كل منها تربط بين مركزين)
  • حساب الصليب incarnation
  • إخراج الملف الشخصي من خط بوابة الشمس + خط بوابة الأرض (الشخصية والتصميم)

تعد واجهات برمجة التطبيقات (APIs) القادرة على كل هذا نادرة جداً. توفر واجهة برمجة تطبيقات AstroWay للتصميم البشري 12 نقطة نهاية للتصميم البشري — أعمق تغطية رأيناها في واجهة برمجة تطبيقات تجارية.

نقاط نهاية الـ 12 للتصميم البشري في AstroWay

Section titled “نقاط نهاية الـ 12 للتصميم البشري في AstroWay”
نقطة النهايةالتكلفةالإرجاع
/v1/human-design50خريطة التصميم البشري الكاملة
/v1/human-design/transits50عبور التصميم البشري لتاريخ معين
/v1/human-design/compatibility100توافق خريطتين للتصميم البشري
/v1/hd/incarnation-cross50الصليب incarnation
/v1/hd/dream-rave50خريطة Dream Rave
/v1/hd/hologenetic50الملف الشخصي Hologenetic
/v1/hd/sensitivity50تحليل الحساسية للوقت
/v1/hd/circuitry20تحليل الدوائر
/v1/hd/penta100Penta — ديناميكية المجموعة لثلاثة إلى خمسة أشخاص
/v1/hd/group-overlay100Group overlay
/v1/hd/design-date10حساب تاريخ التصميم
/v1/hd/rave-new-years10تواريخ Rave New Year

كيفية إضافة ميزة التصميم البشري

Section titled “كيفية إضافة ميزة التصميم البشري”

تخيل أنك تضيف التصميم البشري إلى تطبيق التنجيم الموجود لديك. ابدأ بنقطة النهاية الرئيسية:

import { Astroway } from '@astroway/sdk';
const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const hd = await client.humanDesign({
date: '1990-07-14',
time: '14:30:00',
timezoneOffset: 3,
latitude: 50.4501,
longitude: 30.5234,
});
console.log(`النوع: ${hd.type}`); // على سبيل المثال، "Generator"
console.log(`الاستراتيجية: ${hd.strategy}`); // على سبيل المثال، "To Respond"
console.log(`السلطة: ${hd.authority}`); // على سبيل المثال، "Sacral"
console.log(`الملف الشخصي: ${hd.profile}`); // على سبيل المثال، "1/3"
console.log(`القنوات المحددة: ${hd.channels.length}`);

شكل الاستجابة:

{
"type": "Generator",
"strategy": "To Respond",
"notSelfTheme": "Frustration",
"authority": "Sacral",
"profile": "1/3",
"definition": "single",
"cross": {
"name": "Right Angle Cross of the Sphinx",
"quarter": "Civilization",
"gates": [1, 2, 7, 13]
},
"centers": [
{ "name": "Sacral", "defined": true },
...
],
"channels": [
{ "gate1": 34, "gate2": 20, "name": "Channel of Charisma", "type": "Generated" }
],
"personalityActivations": [...],
"designActivations": [...]
}

الديناميكية الجماعية عبر Penta

Section titled “الديناميكية الجماعية عبر Penta”

Penta هي تقنية لفهم ديناميكية الفريق في مجموعات من 3 إلى 5 أشخاص. إنها نادرة — معظم أدوات حساب التصميم البشري لا تقدمها. لكنها كنز للتقنيات المتعلقة بالموارد البشرية (HR-tech)، ومنصات التدريب، وتطبيقات بناء الفريق.

const penta = await client.hdPenta({
members: [
{ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
{ date: '1988-03-10', time: '08:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },
{ date: '1985-11-22', time: '18:00:00', timezoneOffset: -5, latitude: 40.71, longitude: -74.00 },
],
});
console.log(`نوع Penta: ${penta.type}`);
console.log(`القنوات المحددة في المجموعة: ${penta.definedChannels.length}`);

الحساسية — حاسمة للدقة

Section titled “الحساسية — حاسمة للدقة”

خريطة التصميم البشري حساسة لوقت الولادة. خطأ بمقدار 10 دقائق يمكن أن يغير الملف الشخصي (على سبيل المثال، من 1/3 إلى 1/4). بالنسبة للمستخدمين الذين لا يعرفون الوقت الدقيق، قم بتشغيل تحليل الحساسية:

const sensitivity = await client.hdSensitivity({
date: '1990-07-14',
time: '14:30:00',
timezoneOffset: 3,
latitude: 50.4501,
longitude: 30.5234,
});
// سيظهر sensitivity أي الحقول ستتغير عند إزاحة الوقت بمقدار ±5/15/30 دقيقة

استخدم هذا لتحذير المستخدم: «عند هذه الدقة، قد يتغير ملفك الشخصي. اعتبر إعادة التحديد (rectification)».

الأسعار لتطبيقات التصميم البشري

Section titled “الأسعار لتطبيقات التصميم البشري”

إذا كنت تبني تطبيقاً يركز على التصميم البشري:

  • مستخدم أساسي: خريطة تصميم بشري واحدة عند التسجيل، مخزنة إلى الأبد = 50 نقطة ائتمان لمرة واحدة
  • مستخدم نشط: عبور دوري + توافق ≈ 200 نقطة ائتمان/شهر
  • 100 مستخدم نشط يومياً مع استخدام معتدل للتصميم البشري: ≈ 110,000 نقطة ائتمان/شهر → Starter ($19/شهر) يكفي بسهولة
  • 1,000 مستخدم نشط يومياً: ≈ 150,000 نقطة ائتمان/شهر → Pro ($59/شهر)

طلبات التوافق هي الأكثر تكلفة (100 نقطة ائتمان). قم بتخزين النتائج لكل زوج من المستخدمين إلى الأبد (فهي ثابتة).

يتم عادةً rendering رسم الجسم (bodygraph) عبر SVG. ترجع واجهة برمجة التطبيقات (API) بيانات حول المراكز والقنوات؛ يمكنك rendering العرض البصري. مثال:

function Bodygraph({ hd }: { hd: HDChart }) {
return (
<svg viewBox="0 0 400 600">
{hd.centers.map(c => (
<polygon
key={c.name}
points={CENTER_COORDS[c.name]}
fill={c.defined ? CENTER_COLORS[c.name] : 'white'}
stroke="black"
/>
))}
{hd.channels.map(ch => (
<line
key={`${ch.gate1}-${ch.gate2}`}
x1={GATE_COORDS[ch.gate1].x}
y1={GATE_COORDS[ch.gate1].y}
x2={GATE_COORDS[ch.gate2].x}
y2={GATE_COORDS[ch.gate2].y}
stroke="#d4a84c"
strokeWidth="3"
/>
))}
</svg>
);
}

الاحداثيات ثابتة (كل رسم جسم لديه نفس الـ 9 مراكز و64 بوابة في نفس المواضع).

ابدأ ببناء ميزات التصميم البشري

Section titled “ابدأ ببناء ميزات التصميم البشري”
AstroWay team

فريق هندسة AstroWay API. نغلف Swiss Ephemeris في REST نظيف ونكتب عن التفاصيل المملة التي تهم حقاً.

// ابنِ عليه

نفس Swiss Ephemeris الموجود في Solar Fire — في 4 أسطر من الكود.

مفتاح مجاني بدون بطاقة. 5000 استدعاء شهرياً حتى الدفعة الأولى.

المزيد من المدونة جميع المقالات →

Engineering 2026-06-05

Natal Chart API in TypeScript: SDK + React Example

Compute a natal chart in TypeScript with the AstroWay SDK — typed responses, a React component, and where it beats a local ephemeris library.

Ephemeris 2026-06-05

How Accurate Is the Swiss Ephemeris? Verified Benchmarks

Swiss Ephemeris accuracy in numbers — planetary positions under 0.1 arcsecond, exact house cusps, eclipses within a minute — and how AstroWay verifies it.

Ephemeris 2026-06-05

Swiss Ephemeris: REST API vs pyswisseph (When to Use Which)

pyswisseph vs a REST API for Swiss Ephemeris calculations — C dependencies, data files, licensing and deployment compared, with a decision guide.