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

قرّب إلى أقرب سنت

قرّب إلى أقرب سنت: أدخل بياناتك وشاهد نتيجة واضحة في الصفحة نفسها. الفحوص الفردية مجانية، والواجهة البرمجية تبدأ من $0.002.

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

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

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

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

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

راجع بياناتك

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

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

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

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

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

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

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

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

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

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

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

ماذا يعني التقريب إلى أقرب سنت؟

يعني الإبقاء على رقمين تمامًا بعد النقطة العشرية (سنت واحد) وتطبيق half-up على الباقي. يصبح 1.234 هو 1.23؛ ويصبح 1.235 هو 1.24.

أي قاعدة تقريب تُستخدم لنصف السنت؟

half-up، ويُسمّى أيضًا الابتعاد عن الصفر. أول رقم مطروح قدره 5 أو أكبر يزيد المقدار، لذا يصبح 1.235 هو 1.24 ويصبح −1.235 هو −1.24.

ماذا يجب أن تُرسل؟

عددًا متناهيًا في amount (الأسماء البديلة value وn وnumber وinput وx وmoney). وتُرفض رموز العملة والسلاسل الفارغة وNaN وInfinity بـ invalid_input.

لماذا توجد سلسلة display إلى جانب العدد؟

تسقط أعداد JSON الأصفار الختامية، لذا سيصبح 20.00 هو 20. ويحمل حقل display منزلتين دائمًا؛ وcents هي القيمة نفسها عددًا صحيحًا موقعًا للبنسات.

كم تكلفة حاسبة أقرب سنت؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/math/round-to-the-nearest-penny

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

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

curl -X POST https://api.kit.forhosting.com/math/round-to-the-nearest-penny \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":1.235}'

const res = await fetch("https://api.kit.forhosting.com/math/round-to-the-nearest-penny", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount": 1.235
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/round-to-the-nearest-penny",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "amount": 1.235
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/round-to-the-nearest-penny", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"amount":1.235}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"amount":1.235}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/round-to-the-nearest-penny", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "amount": 1.235
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_abs 1000000000000000

الأخطاء

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

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