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

حساب تقدم هدف الخطوات اليومي والخطوات المتبقية

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

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

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

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

أدخلوا الهدف وخطوات اليوم المسجلة

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

افهموا النسبة وعدد الخطوات المتبقية

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

استخدموا النتيجة في العادات والتطبيقات

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

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

مراجعة هدف مشي شخصي

اطلعوا على النسبة المنجزة والعدد الدقيق المطلوب من الخطوات قبل نهاية اليوم.

تغذية لوحة متابعة النشاط

حوّلوا الهدف وعدد المتتبع إلى نسبة تقدم وخطوات متبقية وحالة اكتمال واضحة.

التحكم في تذكيرات الحركة

أوقفوا التنبيهات آلياً بمجرد أن تؤكد النتيجة تحقق هدف الخطوات اليومي.

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

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

يُقسم عدد الخطوات المنجزة على الهدف ثم يُضرب الناتج في مئة، وتُقرب النتيجة إلى منزلتين عشريتين.

ماذا يحدث عند تجاوز الهدف؟

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

هل يجوز أن يكون الهدف صفراً أو سالباً؟

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

هل يمكن أن تكون الخطوات المنجزة سالبة أو كسرية؟

لا. يجب أن تكون عدداً صحيحاً غير سالب لأن الخطوات وحدات منفصلة قابلة للعد.

ما كلفة استخدام API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/final3/step-goal-progress-percent

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

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

curl -X POST https://api.kit.forhosting.com/final3/step-goal-progress-percent \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"step_goal":10000,"steps_taken":6750}'

const res = await fetch("https://api.kit.forhosting.com/final3/step-goal-progress-percent", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "step_goal": 10000,
    "steps_taken": 6750
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/step-goal-progress-percent",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "step_goal": 10000,
    "steps_taken": 6750
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/step-goal-progress-percent", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"step_goal":10000,"steps_taken":6750}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"step_goal":10000,"steps_taken":6750}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/step-goal-progress-percent", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "step_goal": 10000,
  "steps_taken": 6750
}

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

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