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

المفتاح من عدد الروافع أو الخوافض

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

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

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

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

يعدّ الطلاب الإشارات الرافعة أو الخافضة ثم يستذكرون دائرة الخماسيات؛ ويحتاج المعلّمون ومطوّرو التطبيقات إلى نفس التطابق دون جداول يدوية تختلف في دو بيمول الكبير أو لا دييز الصغير. تقبل حاسبة المفتاح من العوارض عددًا صحيحًا من صفر إلى سبعة ونوعًا رافعًا أو خافضًا، ثم تُرجع المفتاح الكبير والصغير الطبيعي النسبي والقائمة المرتبة للعوارض بترتيب التوقيع وتسمية مقروءة للتوقيع. صفر عوارض يعني دو الكبير و لا الصغير لأي من النوعين. منطق التحليل الخالص متطابق في الأداة المجانية بالمتصفح ومسار API، فلا تختلف مصححات الواجبات أو إضافات LMS أو مساعدات التدوين حول المفاتيح عند خمسة خوافض أو ستة روافع.

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

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

راجع بياناتك

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

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

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

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

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

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

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

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

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

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

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

كيف يُوجد المفتاح الكبير والصغير من عدد الروافع؟

أرسلوا count (0–7) و kind "sharp". تُرجع API الحقول major_key و minor_key والعوارض المرتبة (F#, C#, …). مثال: count 2 → ري الكبير و سي الصغير مع F# و C#.

وماذا عن الخوافض؟

استخدموا kind "flat" (أو flats, b). count 3 يُرجع Eb major و C minor والعوارض Bb, Eb, Ab. count 0 هو دو الكبير / لا الصغير لأي من النوعين.

لماذا الحد الأقصى لـ count هو 7؟

تستخدم تواقيع المفتاح النغمية القياسية سبعة روافع على الأكثر (C# major) أو سبعة خوافض (Cb major). تُرفض القيم خارج 0–7 باعتبارها invalid_input.

هل الصغير هارموني أم ميلودي؟

يُرجع الطرف الصغير الطبيعي النسبي الذي يشارك نفس التوقيع (مثل لا الصغير مع دو الكبير). درجات الحس المرفوعة في الصغير الهارموني أو الميلودي ليست جزءًا من توقيع المفتاح ذاته.

كم تكلفة حاسبة توقيع المفتاح؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/hobby/music-key-from-accidentals

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

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

curl -X POST https://api.kit.forhosting.com/hobby/music-key-from-accidentals \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2,"kind":"sharp"}'

const res = await fetch("https://api.kit.forhosting.com/hobby/music-key-from-accidentals", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "count": 2,
    "kind": "sharp"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/hobby/music-key-from-accidentals",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "count": 2,
    "kind": "sharp"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/music-key-from-accidentals", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"count":2,"kind":"sharp"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"count":2,"kind":"sharp"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/music-key-from-accidentals", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "count": 2,
  "kind": "sharp"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "hobby.music_key_from_accidentals",
  "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 الكامل ←