انتقل إلى المحتوى

البدء مع The Numerology API – دليل سريع للمبتدئين

مرحبًا بك في The Numerology API! هذا الدليل الشامل سيساعدك على الانتقال من الصفر إلى أول حساب ناجح لعلم الأرقام في دقائق قليلة. سواء كنت تعمل على بناء تطبيق أرقام أو موقع تنجيم أو منصة توقعات يومية أو أداة عافية رحية، فإن واجهة برمجة التطبيقات الخاصة بنا مع أكثر من 100 نقطة وصول تجعل من السهل إضافة رؤى رقمية احترافية.

لماذا تختار The Numerology API؟

  • أكثر من 100 نقطة وصول: احسب Life Path Number و Destiny/Expression Number و Heart's Desire (Soul Urge) و Personality Number و Attitude Number و Karmic Debt و Karmic Lessons و Personal Year و Essence Cycles و Minor Expressions و Bridge Numbers والمزيد.
  • نظام Pythagorean Numerology: حسابات دقيقة ومُجرّبة عبر الزمن مع معانٍ مفصلة ودعم للأرقام الرئيسية (11, 22, 33). مضيف على RapidAPI: اشتراك بسيط، وقت تشغيل موثوق، وخطط أسعار قابلة للتوسع (متاح خطة مجانية).
  • ودود للمطورين: يدعم طرق GET و POST، وردود JSON، وتكامل سهل بأي لغة.

خطوة بخطوة: التسجيل والحصول على مفتاح API الخاص بك

  1. قم بزيارة The Numerology API على RapidAPI الرسمي
  2. انقر على "Subscribe to Test" واختر خطة:
  3. Basic (مجاني) – 100 طلب/شهر – مثالي للاختبار
  4. Pro – 130,000 طلب/شهر
  5. Ultra (موصى به) – 550,000 طلب/شهر
  6. Mega – 2,000,000 طلب/شهر
  7. بعد الاشتراك، انسخ X-RapidAPI-Key الخاص بك من علامة التبويب "Endpoints".

أول طلب لك: حساب Life Path Number

Life Path Number هو أحد أهم الأرقام في علم الأرقام. إليك كيفية حسابه باستخدام نقطة الوصول GET.

مثال بلغة Python

import requests

url = "https://the-numerology-api.p.rapidapi.com/life_path"

# Example: Birth date May 15, 1990
querystring = {
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY_HERE",
    "X-RapidAPI-Host": "the-numerology-api.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

if response.status_code == 200:
    data = response.json()
    print(f"Life Path Number: {data['life_path_number']}")
    print(f"Summary: {data['summary']}")
    print(f"Detailed Meaning: {data['detailed_meaning']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

المخرجات المتوقعة (لتاريخ 1997-08-17): 

{
  "life_path_number": 11,
  "summary": "The life path number 11 is a master number that represents intuition, spirituality, and enlightenment...",
  "detailed_meaning": "Master Number 11 represents intuition, inspiration, and spiritual insight..."
}

مثال بلغة JavaScript (Fetch)

const url = "https://the-numerology-api.p.rapidapi.com/life_path";

const options = {
  method: 'GET',
  headers: {
    'X-RapidAPI-Key': 'YOUR_API_KEY_HERE',
    'X-RapidAPI-Host': 'the-numerology-api.p.rapidapi.com'
  },
  // Query parameters
  // Add as URL search params
};

fetch(`${url}?birth_year=1990&birth_month=5&birth_day=15`, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

بديل باستخدام طلب POST (JSON Body)

تدعم نقاط الوصول العديدة كلاً من GET و POST. إليك نسخة POST لـ Life Path:

payload = {
    "birth_year": 1990,
    "birth_month": 5,
    "birth_day": 15
}

response = requests.post(url, json=payload, headers=headers)

الأخطاء الشائعة واستكشاف الأخطاء وإصلاحها

  • 401 Unauthorized: تحقق من مفتاح API وحالة اشتراكك.
  • 400 Bad Request: تأكد من وجود المعاملات المطلوبة وشكلها الصحيح.
  • 429 Too Many Requests: لقد تجاوزت حد خطتك – قم بالترقية لمزيد من الطلبات.

ما الخطوة التالية؟

الآن بعد أن قمت بأول اتصال، استكشف نقاط الوصول الشائعة التالية:

تصفح مرجع API الكامل لاكتشاف جميع نقاط الوصول البالغ عددها أكثر من 100.

هل أنت مستعد لبناء شيء مذهل؟ ابدأ في دمج عمليات حساب علم الأرقام و مميزات التنجيم و التوقعات الشخصية اليوم!

الوسوم: #numerologyapi #lifepathnumber #destinynumber #numerologytutorial #pythonapi #rapidapi #spiritualapp #astrologyapi #horoscopeapi #gettingstarted #pythagoreannumerology #masternumbers