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

حاسبة دائرة البراغي

دائرة البراغي، وتُدعى أيضاً دائرة الخطوة أو دائرة ثقوب البراغي، هي الدائرة التي تمر بمراكز ثقوب التثبيت المتساوية التباعد على شفة أو بكرة أو محور أو غطاء.

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

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

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

كان تخطيط الورشة يعني منقلة وفرجاراً وتحققاً ثانياً من أن الثقب الأول قد وقع فعلاً عند زاوية البدء المعلَّمة. تأخذ حاسبة دائرة البراغي هذه إحداثيات المركز، وقطر الدائرة (قطر دائرة الخطوة، أو PCD)، وعدد الثقوب، وزاوية البدء بالدرجات، ثم تعيد كل ثقب بإحداثيي سيني وصادي ديكارتيين. يطبّق المحرك الهوية القطبية المعتادة: نصف القطر يساوي القطر مقسوماً على اثنين، والخطوة الزاوية ثلاثمئة وستون درجة مقسومة على عدد الثقوب، ويقع الثقب i عند زاوية البدء زائداً i أمثال تلك الخطوة، مع الصفر على محور السينات الموجب والزوايا تتزايد عكس عقارب الساعة. يجب أن يكون عدد الثقوب عدداً صحيحاً موجباً؛ فالصفر أو الكسر أو القيمة السالبة يفشل بـ invalid_input ولا يُحاسب. يغذّي الوحدة الصرفة نفسها الأداة المجانية في المتصفح وواجهة API بسعر $0.002 لكل استدعاء ناجح، حتى لا يختلف رسم شفة وتثبيت CNC على إحداثي واحد.

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

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

راجع بياناتك

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

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

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

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

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

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

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

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

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

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

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

كيف تُحسب الثقوب المتساوية التباعد على دائرة براغي؟

أرسلوا center_x وcenter_y وdiameter (PCD) وhole_count وstart_angle بالدرجات. تعيد API لكل ثقب x = center_x + r cos(θ) وy = center_y + r sin(θ)، مع r = diameter/2 وθ = start_angle + i × 360/n.

أين يقع صفر الدرجات وهل تسير الزوايا مع عقارب الساعة؟

صفر الدرجات هو محور السينات الموجب (الساعة الثالثة). تتزايد الزوايا الموجبة عكس عقارب الساعة، مطابقة لإحداثيات CAD القطبية. لوضع الثقب 1 عند الساعة 12 أرسلوا start_angle بقيمة 90.

ماذا يحدث إذا لم يكن عدد الثقوب عدداً صحيحاً موجباً؟

تفشل المهمة بـ invalid_input. لا يمكن للأصفار والسالبة والكسور أن تعرّف دائرة براغي متساوية التباعد ولا تُحاسب.

هل القطر هو قطر دائرة الخطوة أم قطر الثقب؟

Diameter هو قطر دائرة الخطوة (PCD) الذي يمر بمراكز الثقوب، لا قطر الثقوب نفسها. يجب أن تطابق الوحدات الخطية إحداثيات المركز.

كم تكلفة حاسبة دائرة البراغي؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقاً بسعر $0.002 لكل استدعاء ناجح؛ ولا يُحاسب الإدخال غير الصالح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/build/bolt-circle

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

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

curl -X POST https://api.kit.forhosting.com/build/bolt-circle \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"center_x":0,"center_y":0,"diameter":100,"hole_count":4,"start_angle":0}'

const res = await fetch("https://api.kit.forhosting.com/build/bolt-circle", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "center_x": 0,
    "center_y": 0,
    "diameter": 100,
    "hole_count": 4,
    "start_angle": 0
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/build/bolt-circle",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "center_x": 0,
    "center_y": 0,
    "diameter": 100,
    "hole_count": 4,
    "start_angle": 0
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/build/bolt-circle", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"center_x":0,"center_y":0,"diameter":100,"hole_count":4,"start_angle":0}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"center_x":0,"center_y":0,"diameter":100,"hole_count":4,"start_angle":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/build/bolt-circle", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "center_x": 0,
  "center_y": 0,
  "diameter": 100,
  "hole_count": 4,
  "start_angle": 0
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_holes 1000

الأخطاء

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

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