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

حاسبة نسبة الدرجة الحالية من الأعمال المصححة

تجيب نسبة الدرجة الحالية عن سؤال محدد: ما مستوى أدائكم في الأعمال التي صُححت فعلاً؟ أدخلوا النقاط المحصّلة والنقاط الممكنة لكل واجب، ثم ضعوا علامة غير مصحح على كل عمل لم تُنشر درجته بعد.

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

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

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

تستبعد الحاسبة تلك الأعمال المعلّقة من كلا المجموعين، وتجمع نقاط الأعمال المصححة، ثم تعرض النسبة المحققة حتى الآن. وهكذا تحصلون على صورة واضحة لوضعكم اليوم من دون اعتبار العمل المستقبلي أو غير المعاد صفراً.

أدخلوا نقاط سجل الدرجات بدقة

ابدؤوا بالواجبات الظاهرة في سجل المقرر، وانسخوا النقاط المحصّلة والممكنة لكل واحد منها. فإذا كانت نتيجة اختبار قصير 18 من 20، فأدخلوا 18 نقطة محصّلة و20 نقطة ممكنة. اجعلوا كل واجب في صف مستقل لتتمكنوا من مراجعته لاحقاً. لا تضعوا علامة مصحح إلا عندما ينشر المدرس درجة فعلية. وإذا كان المشروع معروضاً بقيمة 100 نقطة ممكنة من دون نتيجة، فاتركوه غير مصحح كي تتجاهله الحاسبة. لا تدخلوا صفراً مؤقتاً إلا إذا كان الصفر هو الدرجة المسجلة فعلاً؛ فالصفر الحقيقي يدخل في الحساب، أما الخانة الفارغة أو المعلّقة فلا تدخل. الأسماء اختيارية، لكن تسميات مثل «الاختبار 1» تساعد على كشف الصفوف المكررة أو الناقصة.

افهموا طريقة الحساب بالنقاط

تجمع الحاسبة النقاط المحصّلة في الصفوف المصححة، ثم تجمع النقاط الممكنة في الصفوف نفسها، وتقسم المجموع الأول على الثاني وتضرب الناتج في 100. فمثلاً، تنتج درجتا 18 من 20 و42 من 50 مجموعاً قدره 60 من 70، أي 85.71 بالمئة عند التقريب إلى منزلتين. يُستبعد كل صف غير مصحح من البسط والمقام معاً، كي لا يتحول العمل المعلّق خطأً إلى صفر. النتيجة درجة حالية مبنية على النقاط، وقد لا تطابق الدرجة الرسمية للمقرر. فبعض المقررات تمنح الامتحانات والواجبات والمشاركة أوزاناً مختلفة، أو تستبعد نتيجة، أو تضيف نقاطاً إضافية. عند وجود فئات موزونة، راجعوا خطة المقرر والمجاميع المعروضة لمعرفة النقاط الداخلة في الحساب.

استخدموا النتيجة كلقطة للوضع الحالي

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

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

معرفة الوضع اليوم

اجمعوا كل الدرجات المنشورة مع استبعاد الأعمال التي لم تُعد بعد.

مراجعة مجموع سجل الدرجات

قارنوا مجموع النقاط المحصّلة والممكنة بالمجموع الذي يعرضه نظام المقرر.

التحديث بعد درجة جديدة

حوّلوا واجباً كان معلّقاً إلى مصحح، ثم أعيدوا حساب النسبة الحالية فوراً.

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

ما الذي تستبعده الحاسبة؟

تستبعد كل واجب محدد بأنه غير مصحح، بما في ذلك نقاطه المحصّلة والممكنة.

هل ينبغي إدخال الواجب بلا درجة على أنه صفر؟

فقط إذا كان الصفر درجة منشورة فعلاً. اتركوا العمل الذي لم يُقيّم بعد غير مصحح.

هل تدعم الحاسبة الفئات الموزونة؟

لا. تحسب نسبة بالنقاط المدخلة، ولذلك قد تنتج أوزان الفئات درجة رسمية مختلفة.

هل يمكن أن تتجاوز النقاط المحصّلة النقاط الممكنة؟

نعم، لأن المدرس قد يمنح نقاطاً إضافية لواجب مصحح.

كيف تُحسب النسبة؟

تُقسم نقاط الأعمال المصححة المحصّلة على نقاطها الممكنة، ويُضرب الناتج في 100 ثم يُقرّب.

ما تكلفة طلب API؟

السعر الأساسي هو $0.002 لكل طلب، ويمكن إجراء الحساب الحتمي نفسه مجاناً في المتصفح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/edu/current-grade-percentage

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

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

curl -X POST https://api.kit.forhosting.com/edu/current-grade-percentage \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}'

const res = await fetch("https://api.kit.forhosting.com/edu/current-grade-percentage", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "assignments": [
      {
        "name": "Quiz 1",
        "earned": 18,
        "possible": 20,
        "graded": true
      },
      {
        "name": "Essay",
        "earned": 42,
        "possible": 50,
        "graded": true
      },
      {
        "name": "Final project",
        "possible": 100,
        "graded": false
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/current-grade-percentage",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "assignments": [
        {
            "name": "Quiz 1",
            "earned": 18,
            "possible": 20,
            "graded": true
        },
        {
            "name": "Essay",
            "earned": 42,
            "possible": 50,
            "graded": true
        },
        {
            "name": "Final project",
            "possible": 100,
            "graded": false
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/current-grade-percentage", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/current-grade-percentage", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "assignments": [
    {
      "name": "Quiz 1",
      "earned": 18,
      "possible": 20,
      "graded": true
    },
    {
      "name": "Essay",
      "earned": 42,
      "possible": 50,
      "graded": true
    },
    {
      "name": "Final project",
      "possible": 100,
      "graded": false
    }
  ]
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 500

الأخطاء

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

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