ForHosting KIT · أدوات المطورين

حاسبة الفترة المدارية بالأيام

عندما تعرفون بالفعل حجم المدار بالوحدات الفلكية والكتلة المركزية بكتل شمسية، تكون الإجابة الطبيعية هي الفترة بالأيام — لا بالثواني في نظام SI التي تفرض تحويلات الوحدات قبل أي تحقق صفّي أو مهمّي.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

ينص قانون كبلر الثالث بالوحدات الشمسية على أن مربع الفترة المدارية بالسنوات يساوي مكعب نصف المحور الأكبر بوحدة AU مقسومًا على الكتلة المركزية بكتل شمسية؛ لذا تكون الفترة بالأيام اليوليانية ثلاثمائة وخمسة وستين فاصلة اثنين خمسة مضروبة في الجذر التربيعي لـ a مكعبًا على M. يتحقق الطلاب من تمارين سنة الأرض أو المريخ دون تحويل AU والكتل الشمسية إلى أمتار وكيلوغرامات؛ وتحتاج عروض الكواكب الخارجية إلى أطوال سنة مقروءة من a وM_star في الفهرس؛ وتحتاج سكربتات التصحيح إلى مَرجع حتمي يرفض الكتلة غير الموجبة بدل إرجاع NaN. تقبل حاسبة الفترة المدارية بالأيام هذه الحقلين semi_major_axis_au وmass_solar، وتعيد period_days كنتيجة رئيسية مع period_years والحركة المتوسطة للمراجعة، وتفشل بـ invalid_input عندما تكون الكتلة صفرًا أو سالبة. يشترك المسار المجاني في المتصفح وواجهة API في دالة متماثلة الشكل نقية واحدة، فلا تختلف العروض والاختبارات أبدًا.

طريقة الاستخدام

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

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

حالات الاستخدام

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.

الأسئلة الشائعة

كيف أستخدم هذه الإمكانية؟

أكمل الحقول أعلاه وشغّلها في هذه الصفحة. يوضح النموذج أي بيانات تحتاج إلى تصحيح.

للمطوّرين — الوصول عبر API

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

الـEndpoint

POSThttps://api.kit.forhosting.com/astro/orbital-period-days

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/astro/orbital-period-days \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"semi_major_axis_au":1,"mass_solar":1}'

const res = await fetch("https://api.kit.forhosting.com/astro/orbital-period-days", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "semi_major_axis_au": 1,
    "mass_solar": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/orbital-period-days",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "semi_major_axis_au": 1,
    "mass_solar": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/orbital-period-days", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"semi_major_axis_au":1,"mass_solar":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"semi_major_axis_au":1,"mass_solar":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/orbital-period-days", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "semi_major_axis_au": 1,
  "mass_solar": 1
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.orbital_period_days",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←