حجم الكرة
الكرة هي مجموعة النقاط في الفضاء الثلاثي الأبعاد على مسافة موجبة ثابتة من مركز. تلك المسافة هي نصف القطر؛ والقطر ضعف نصف القطر وهو أطول وتر عبر الجسم.
شغّل الأداة مجانًا
بمجرد معرفة نصف القطر أو القطر وكونه موجبًا بصرامة، تُحدَّد كل المقاييس الكلاسيكية للجسم: الحجم أربعة أثلاث باي في مكعب نصف القطر، ومساحة السطح أربعة باي في مربع نصف القطر. يلتقي الطلاب بهذه الصيغ في واجبات وامتحانات ومسائل الهندسة الفراغية؛ ويحتاج المهندسون والمصممون والمصنّعون الأرقام نفسها عندما يسرد رسم أو قائمة مواد أو ملاحظة تغليف نصف قطر فقط أو قطرًا فقط. تقبل هذه القدرة واحدًا بالضبط من نصف القطر أو القطر، وترفض القيم السالبة وغير الموجبة والمدخلات الغامضة متعددة الحقول، وتعيد نصف القطر والقطر والحجم ومساحة السطح كـ JSON منظم. تغذي الدالة النقية نفسها الـ widget المجاني في المتصفح ومسار API المدفوع مسبقًا، فيطابق مثال golden على الخادم ما ينفّذه الزائر محليًا دون ذهاب وإياب شبكي ودون تدخل نموذج لغوي.
طريقة الاستخدام
أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.
راجع بياناتك
اتبع التسميات والوحدات الموضحة بجانب كل حقل. إذا كانت قيمة مفقودة أو خارج النطاق، توضح الصفحة الحقل الذي يحتاج إلى تصحيح.
أعد الحساب أو نفّذه آليًا
استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.
حالات الاستخدام
احصل على النتيجة الآن
أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.
قارن السيناريوهات
غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.
أتمت العمل المتكرر
استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.
الأسئلة الشائعة
كيف أحسب حجم الكرة ومساحة سطحها بهذه API؟
أرسلوا جسم JSON يتضمن واحدًا بالضبط من radius أو diameter إلى geom.sphere_volume. تعيد الاستجابة radius وdiameter وvolume وsurface_area.
أي صيغ تستخدمها الحاسبة؟
الحجم هو (4/3)·π·r³. مساحة السطح هي 4·π·r². القطر هو 2·r. من القطر، نصف القطر هو diameter/2 قبل تطبيق الصيغ نفسها.
ماذا يحدث إن كان نصف القطر سالبًا؟
يفشل الطلب بـ invalid_input. تتطلب الكرة نصف قطر موجبًا بصرامة (أو قطرًا موجبًا مكافئًا)؛ تُرفض القيم السالبة ولا تُحسب تلك الاستدعاءات.
هل حاسبة حجم الكرة مجانية؟
تعمل أداة المتصفح مجانًا على جهازكم. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بـ $0.002 لكل بند ناجح؛ وفشل التحقق لا يُحسب.
هل يمكنني إرسال نصف القطر والقطر معًا؟
لا. قدّموا حقلًا واحدًا بالضبط. إرسال الاثنين فرط تحديد ويفشل بـ invalid_input حتى لا تختفي الأزواج غير المتسقة خلف تفضيل صامت لمقياس واحد.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/geom/sphere-volume \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"radius":3,"diameter":6}'const res = await fetch("https://api.kit.forhosting.com/geom/sphere-volume", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"radius": 3,
"diameter": 6
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geom/sphere-volume",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"radius": 3,
"diameter": 6
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geom/sphere-volume", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"radius":3,"diameter":6}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"radius":3,"diameter":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geom/sphere-volume", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"radius": 3,
"diameter": 6
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geom.sphere_volume",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |