البدء في استخدام NumerologyAPI¶

هذا الدليل يوجهك خلال:

• إنشاء حساب للمطور
• إنشاء مفتاح API
• فهم المصادقة
• إرسال أول طلب API الخاص بك

يوفر NumerologyAPI أكثر من 203 نقطة نهاية جاهزة للاستخدام تغطي:

• عمليات الحساب المتعلقة بالعلم الفلكي
• رؤى في علم التنجيم
• توافق الأبراج
• أرقام الملائكة
• تفسيرات مخطط الميلاد

تدعم جميع نقاط النهاية استجابات متعددة اللغات.

1. إنشاء حساب المطور الخاص بك¶

الطريقة الموصى بها للوصول إلى NumerologyAPI هي من خلال المنصة الرسمية للمطورين.

1. افتح لوحة تحكم المطور https://dashboard.numerologyapi.com

2. أنشئ حسابك

3. قم بإنشاء مفتاح API لمؤسستك

4. أضف رصيدًا إلى محفظتك (دفع حسب الاستخدام)

سيبدو مفتاح API الخاص بك مشابهًا لما يلي:

tnea_xxxxxxxxxxxxxxxxx

2. عنوان URL الأساسي¶

يتم إرسال جميع الطلبات إلى بوابة NumerologyAPI.

مثال على نقطة نهاية:

https://api.numerologyapi.com/api/v1/life_path

3. المصادقة¶

يجب أن يتضمن كل طلب مفتاح واجهة برمجة التطبيقات (API) الخاص بك.

x-api-key: YOUR_API_KEY

أمثلة على رؤوس الطلب:

GET /api/v1/life_path HTTP/1.1
Host: api.numerologyapi.com
x-api-key: YOUR_API_KEY

4. الطلب الأول - رقم مسار الحياة¶

طلب GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  --header "x-api-key: YOUR_API_KEY"

5. طلب POST (جسم JSON)¶

تدعم بعض نقاط النهاية أيضًا طلبات POST.

curl --request POST \
  --url https://api.numerologyapi.com/api/v1/life_path \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
  }'

6. دعم اللغة¶

تدعم جميع نقاط النهاية المعلمة الاختيارية: lang.

مثال:

?lang=fr

اللغات المدعومة:

مثال على الطلب:

/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=es

7. أمثلة التعليمات البرمجية¶

بايثون (requests)¶

import requests

url = "https://api.numerologyapi.com/api/v1/life_path"

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

headers = {
    "x-api-key": "YOUR_API_KEY"
}

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

print(response.json())

PHP (cURL)¶

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: YOUR_API_KEY"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

?>

JavaScript (Fetch)¶

const url = new URL("https://api.numerologyapi.com/api/v1/life_path");

url.searchParams.append("birth_year", "1990");
url.searchParams.append("birth_month", "5");
url.searchParams.append("birth_day", "15");

fetch(url, {
    method: "GET",
    headers: {
        "x-api-key": "YOUR_API_KEY"
    }
})
.then(r => r.json())
.then(console.log);

Node.js (axios)¶

const axios = require("axios");

axios.get("https://api.numerologyapi.com/api/v1/life_path", {
  params: {
    birth_year: 1990,
    birth_month: 5,
    birth_day: 15
  },
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
.then(res => console.log(res.data));

8. نموذج الفوترة¶

يستخدم NumerologyAPI نظام فوترة يعتمد على أرصدة.

1 API request = 1 credit
1 USD = 3,921.57 credits

تُوزع الأرصدة عبر جميع 203+ نقاط النهاية.

للحصول على التفاصيل الكاملة، يرجى زيارة الأسعار.

9. الوصول إلى RapidAPI¶

تتوفر واجهة Numerology API أيضًا على RapidAPI للمطورين الذين يستخدمون بالفعل هذا السوق.

يتطلب RapidAPI هذه الرؤوس:

x-rapidapi-key
x-rapidapi-host

مثال على نقطة النهاية:

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

يمكنك الوصول إليها هنا:

https://rapidapi.com/dakidarts-dakidarts-default/api/the-numerology-api

الخطوات التالية¶

الآن بعد أن قمت بطلبك الأول:

• استكشف مرجع API لجميع نقاط النهاية
• راجع أسعار لفهم أرصدة الاعتماد
• تحقق من سجل التغييرات للحصول على التحديثات

الآن أنت جاهز لدمج NumerologyAPI في تطبيقك.