قراءة عقد الروح¶
نقطة النهاية قراءة عقد الروح تُرجع مخرجات علم الأعداد لفهم عقد الروح. استخدم هذه الصفحة لقواعد المعلمات الجاهزة للتكامل، وخيارات الاستخدام المسموح بها، وأمثلة الاستجابة.
نقطة النهاية¶
| الطريقة | المسار |
|---|---|
GET | https://api.numerologyapi.com/api/v1/soul-contract-reading |
POST | https://api.numerologyapi.com/api/v1/soul-contract-reading |
التوفر¶
- المصادقة:
X-API-Key(أوAuthorization: Bearer YOUR_API_KEY) - قيم
langالمدعومة:en،es،de،fr،pt - قناة الوصول: واجهة برمجة التطبيقات المباشرة (
https://api.numerologyapi.com) - بوابة RapidAPI: غير مدعومة حاليًا لنقاط النهاية المطولة
المعلمات¶
معلمات استعلام GET| المعلمة | النوع | مطلوب | افتراضي | الخيارات | الوصف |¶
|---|---|---|---|---|---| | full_name | string | نعم | — | الطول: 1..160؛ السماح بالحروف والمسافات؛ الحد الأقصى لـ 160 حرف | الاسم الكامل أو الاسم الكامل الحالي | | dob | string | نعم | — | النمط: ^\d{4}-\d{2}-\d{2}$ | تاريخ الميلاد بتنسيق YYYY-MM-DD | | lang | string | لا | en | en، es، de، fr، pt | لغة الاستجابة (مدعومة: en, es, de, fr, pt) | | num_sys | string | لا | pythagorean | pythagorean، chaldean، vedic | نظام علم التنجيم الاختياري. القيم المدعومة: pythagorean، chaldean، vedic. القيمة الافتراضية هي pythagorean |
معلمات طلب POST¶
| المعلمة | النوع | مطلوب | افتراضي | الخيارات | الوصف |
|---|---|---|---|---|---|
lang | string | لا | en | en، es، de، fr، pt | لغة الاستجابة (مدعومة: en, es, de, fr, pt) |
معلمات نص POST| المعلمة | النوع | مطلوب | افتراضي | الخيارات | الوصف |¶
|---|---|---|---|---|---| | full_name | string | نعم | — | الطول: 1..160؛ السماح بالحروف/المسافات؛ الحد الأقصى لـ 160 حرف | الاسم الكامل لتحليل علم الأرقام. | | dob | string | نعم | — | النمط: ^\d{4}-\d{2}-\d{2}$ | تاريخ الميلاد بتنسيق YYYY-MM-DD. | | num_sys | string | لا | pythagorean | pythagorean، chaldean، vedic | نظام علم الأرقام الاختياري. القيم المدعومة: pythagorean، chaldean، vedic. القيمة الافتراضية هي pythagorean. |
مثال على الاستجابة¶
GET¶
{
"numerology_system": "pythagorean",
"full_name": "John Alan Doe",
"normalized_full_name": "John Alan Doe",
"dob": "1992-07-16",
"letters_only": "JOHNALANDOE",
"letter_breakdown": [
{
"letter": "J",
"value": 1
},
{
"letter": "O",
"value": 6
},
{
"letter": "H",
"value": 8
},
{
"letter": "N",
"value": 5
},
{
"letter": "A",
"value": 1
},
{
"letter": "L",
"value": 3
},
{
"letter": "A",
"value": 1
},
{
"letter": "N",
"value": 5
},
{
"letter": "D",
"value": 4
},
{
"letter": "O",
"value": 6
},
{
"letter": "E",
"value": 5
}
],
"core_numbers": {
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"attitude_number": 5,
"maturity_number": 8,
"primary_hidden_passion": 1,
"life_path_raw_total": 35,
"expression_total": 45,
"heart_desire_total": 19,
"personality_total": 26,
"birth_day_raw": 16,
"attitude_raw": 14,
"maturity_raw": 17
},
"soul_contract_signature": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract"
],
"soul_contract_archetypes": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract",
"Builder / stewardship contract",
"Healing / service contract",
"Karmic restoration contract",
"Manifestation / command contract"
],
"soul_contract_meaning_keys": [
"karmic_refinement_contract",
"leadership_manifestation_contract",
"legacy_phase_contract",
"builder_stewardship_contract",
"healing_service_contract",
"karmic_restoration_contract",
"manifestation_command_contract",
"default"
],
"life_mission_themes": [
"Learning right use of power, wealth, and authority",
"Growing into larger influence, leadership, or building work"
],
"karmic_patterns": [
{
"type": "karmic_debt",
"number": 16,
"theme": "Humility, ego correction, and inner awakening"
},
{
"type": "karmic_lesson",
"number": 2,
"theme": "Sensitivity and cooperation"
},
{
"type": "karmic_lesson",
"number": 7,
"theme": "Faith and introspection"
},
{
"type": "karmic_lesson",
"number": 9,
"theme": "Compassion and closure"
},
{
"type": "attitude_pattern",
"number": 5,
"theme": "Early-life outer attitude strongly shapes current karmic expression"
}
],
"gift_frequencies": [
{
"theme": "Leadership Gift",
"source_number": 8
},
{
"theme": "Service / Healing Gift",
"source_number": 9
},
{
"theme": "Courage and individuality",
"source_number": 1
},
{
"theme": "Adaptability and movement",
"source_number": 5
}
],
"spiritual_lessons": [
"Use power, success, and influence in service of alignment rather than ego",
"Learn how strength can remain open-hearted and wise",
"Develop the qualities represented by your missing number lessons rather than avoiding them",
"Transform repetition into wisdom by facing karmic debts consciously and consistently"
],
"soul_agreements": [
"An agreement to lead, build, or hold responsibility in visible ways"
],
"energetic_markers": {
"hidden_passion_numbers": [
1,
5
],
"karmic_debt_numbers": [
16
],
"karmic_lesson_numbers": [
2,
7,
9
],
"master_vibrations": {}
},
"meaning": {
"soul_contract": {
"title": "Karmic Refinement Contract",
"overview": "This contract suggests that an important part of your incarnation involves correction, refinement, and completion of unfinished energetic lessons. Rather than indicating punishment, this pattern points to a soul that came in with specific distortions, habits, debts, or imbalances ready to be transformed through conscious living.",
"core_message": "Your path is strongly shaped by refinement — the soul appears to be learning through repetition until wisdom becomes embodied.",
"what_this_contract_often_means": [
"Certain lessons may repeat until they are handled with maturity and truth",
"Patterns involving discipline, ego, freedom, responsibility, or humility may carry unusual weight",
"The life may include encounters that force a more conscious way of living",
"Growth often comes less through ease and more through deep correction and re-alignment"
],
"gifts_inside_this_contract": [
"Potential for profound maturity once lessons are integrated",
"Capacity to transmute past imbalance into wisdom",
"A life that can eventually become highly grounded and spiritually honest",
"Authority born from lived refinement rather than theory"
],
"watch_out": [
"Shame or fatalism around karmic language",
"Repeating known patterns while spiritualizing them instead of changing them",
"Resisting humility when the lesson requires surrender or responsibility",
"Trying to bypass karmic work through image, belief, or performance"
],
"integration_guidance": "Treat recurring difficulty as information, not as personal condemnation. Your breakthroughs are likely hidden inside the lessons you stop running from.",
"affirmation": "I transform repetition into wisdom and meet my karmic refinement with courage and truth."
}
},
"detailed_meaning": {
"soul_contract": "This soul contract signifies an agreement to resolve specific past-life patterns, debts, or lessons in this lifetime. You are here to learn patience, humility, and resilience through repeated challenges that mirror unresolved issues. Your path involves recognizing triggers, breaking cycles of behavior, and choosing growth over comfort. However, the shadow side includes feeling victimized by circumstances or repeating mistakes without learning; you may feel burdened by 'bad luck' that is actually curriculum. To honor this contract, practice self-reflection, forgive yourself and others, and view obstacles as teachers. When aligned, you become free of ancestral burdens, proving that karma is not punishment but an opportunity for soul evolution."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "2d77726f6104e004",
"quota": "unlimited",
"usage_tracking": true,
"premium_spiritual_report": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.1",
"endpoint_name": "soul_contract_reading",
"endpoint_description": "Reveals life mission themes, karmic patterns, gift frequencies, spiritual lessons, and soul agreements from full name and date of birth.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-03-28T14:38:06.617630+01:00",
"data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"es",
"de",
"fr",
"pt"
],
"notes": ""
}
}
¶
{
"numerology_system": "pythagorean",
"full_name": "John Alan Doe",
"normalized_full_name": "John Alan Doe",
"dob": "1992-07-16",
"letters_only": "JOHNALANDOE",
"letter_breakdown": [
{
"letter": "J",
"value": 1
},
{
"letter": "O",
"value": 6
},
{
"letter": "H",
"value": 8
},
{
"letter": "N",
"value": 5
},
{
"letter": "A",
"value": 1
},
{
"letter": "L",
"value": 3
},
{
"letter": "A",
"value": 1
},
{
"letter": "N",
"value": 5
},
{
"letter": "D",
"value": 4
},
{
"letter": "O",
"value": 6
},
{
"letter": "E",
"value": 5
}
],
"core_numbers": {
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"attitude_number": 5,
"maturity_number": 8,
"primary_hidden_passion": 1,
"life_path_raw_total": 35,
"expression_total": 45,
"heart_desire_total": 19,
"personality_total": 26,
"birth_day_raw": 16,
"attitude_raw": 14,
"maturity_raw": 17
},
"soul_contract_signature": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract"
],
"soul_contract_archetypes": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract",
"Builder / stewardship contract",
"Healing / service contract",
"Karmic restoration contract",
"Manifestation / command contract"
],
"soul_contract_meaning_keys": [
"karmic_refinement_contract",
"leadership_manifestation_contract",
"legacy_phase_contract",
"builder_stewardship_contract",
"healing_service_contract",
"karmic_restoration_contract",
"manifestation_command_contract",
"default"
],
"life_mission_themes": [
"Learning right use of power, wealth, and authority",
"Growing into larger influence, leadership, or building work"
],
"karmic_patterns": [
{
"type": "karmic_debt",
"number": 16,
"theme": "Humility, ego correction, and inner awakening"
},
{
"type": "karmic_lesson",
"number": 2,
"theme": "Sensitivity and cooperation"
},
{
"type": "karmic_lesson",
"number": 7,
"theme": "Faith and introspection"
},
{
"type": "karmic_lesson",
"number": 9,
"theme": "Compassion and closure"
},
{
"type": "attitude_pattern",
"number": 5,
"theme": "Early-life outer attitude strongly shapes current karmic expression"
}
],
"gift_frequencies": [
{
"theme": "Leadership Gift",
"source_number": 8
},
{
"theme": "Service / Healing Gift",
"source_number": 9
},
{
"theme": "Courage and individuality",
"source_number": 1
},
{
"theme": "Adaptability and movement",
"source_number": 5
}
],
"spiritual_lessons": [
"Use power, success, and influence in service of alignment rather than ego",
"Learn how strength can remain open-hearted and wise",
"Develop the qualities represented by your missing number lessons rather than avoiding them",
"Transform repetition into wisdom by facing karmic debts consciously and consistently"
],
"soul_agreements": [
"An agreement to lead, build, or hold responsibility in visible ways"
],
"energetic_markers": {
"hidden_passion_numbers": [
1,
5
],
"karmic_debt_numbers": [
16
],
"karmic_lesson_numbers": [
2,
7,
9
],
"master_vibrations": {}
},
"meaning": {
"soul_contract": {
"title": "Karmic Refinement Contract",
"overview": "This contract suggests that an important part of your incarnation involves correction, refinement, and completion of unfinished energetic lessons. Rather than indicating punishment, this pattern points to a soul that came in with specific distortions, habits, debts, or imbalances ready to be transformed through conscious living.",
"core_message": "Your path is strongly shaped by refinement — the soul appears to be learning through repetition until wisdom becomes embodied.",
"what_this_contract_often_means": [
"Certain lessons may repeat until they are handled with maturity and truth",
"Patterns involving discipline, ego, freedom, responsibility, or humility may carry unusual weight",
"The life may include encounters that force a more conscious way of living",
"Growth often comes less through ease and more through deep correction and re-alignment"
],
"gifts_inside_this_contract": [
"Potential for profound maturity once lessons are integrated",
"Capacity to transmute past imbalance into wisdom",
"A life that can eventually become highly grounded and spiritually honest",
"Authority born from lived refinement rather than theory"
],
"watch_out": [
"Shame or fatalism around karmic language",
"Repeating known patterns while spiritualizing them instead of changing them",
"Resisting humility when the lesson requires surrender or responsibility",
"Trying to bypass karmic work through image, belief, or performance"
],
"integration_guidance": "Treat recurring difficulty as information, not as personal condemnation. Your breakthroughs are likely hidden inside the lessons you stop running from.",
"affirmation": "I transform repetition into wisdom and meet my karmic refinement with courage and truth."
}
},
"detailed_meaning": {
"soul_contract": "This soul contract signifies an agreement to resolve specific past-life patterns, debts, or lessons in this lifetime. You are here to learn patience, humility, and resilience through repeated challenges that mirror unresolved issues. Your path involves recognizing triggers, breaking cycles of behavior, and choosing growth over comfort. However, the shadow side includes feeling victimized by circumstances or repeating mistakes without learning; you may feel burdened by 'bad luck' that is actually curriculum. To honor this contract, practice self-reflection, forgive yourself and others, and view obstacles as teachers. When aligned, you become free of ancestral burdens, proving that karma is not punishment but an opportunity for soul evolution."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "2d77726f6104e004",
"quota": "unlimited",
"usage_tracking": true,
"premium_spiritual_report": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.1",
"endpoint_name": "soul_contract_reading",
"endpoint_description": "Reveals life mission themes, karmic patterns, gift frequencies, spiritual lessons, and soul agreements from full name and date of birth.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-03-28T14:38:06.617630+01:00",
"data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"es",
"de",
"fr",
"pt"
],
"notes": ""
}
}
ملاحظة
This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.