ForHosting KIT · المال والتمويل

تقدير تكلفة API لكل طلب ورسوم الاستخدام الزائد

في خطة تشمل 100000 استدعاء، يعني استخدام 125000 وجود 25000 استدعاء زائد. أدخل الرسوم الشهرية والحصة المشمولة واستخدامك وسعر الزيادة لترى رسوم الزيادة وإجمالي الشهر والتكلفة الفعلية للاستدعاء الواحد. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

التكلفة الشهرية للخطة: 100
الطلبات المشمولة: 100,000
الطلبات الفعلية: 125,000
سعر الطلب الإضافي: 0.0015

تحصل على

التكلفة المشمولة لكل طلب: 0.001
الطلبات الزائدة: 25,000
تكلفة الزيادة: 37.5
إجمالي التكلفة الشهرية: 137.5

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

من الاشتراك الشهري إلى تكلفة فعلية للوحدة

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

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

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

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

احسبوا الاستخدام المشمول والتجاوز والسعر الفعلي

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

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

استخدموا التقدير لاختيار الخطة وضبط التكلفة الشهرية

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

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

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

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

مراجعة فاتورة المزود الشهرية

أعيدوا بناء الجزء القائم على الطلبات من الفاتورة باستخدام سعر الخطة والاستدعاءات المقاسة وسعر التجاوز المنشور.

إنشاء تنبيهات لميزانية الاستخدام

حوّلوا الحجم الحالي إلى حقول متسقة للطلبات الزائدة والتكلفة الإجمالية والتكلفة الفعلية لكل وحدة في التقارير.

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

ما الفرق بين التكلفة المشمولة والتكلفة الفعلية؟

التكلفة المشمولة هي رسوم الخطة مقسومة على الحصة المشمولة، أي سعر الوحدة إذا استهلكتها كلها. أما الفعلية فهي فاتورة الشهر كاملة مقسومة على الاستدعاءات التي تمت فعلًا، لذا ترتفع حين لا تُستغل الخطة.

كيف تُحسب الاستدعاءات الزائدة؟

هي الاستخدام الذي يتجاوز الحصة المشمولة، ولا تقل أبدًا عن صفر. مع 125000 استدعاء في خطة تشمل 100000، تُضرب الاستدعاءات الزائدة البالغة 25000 في سعر الزيادة وتُضاف إلى رسوم الخطة.

هل يمكنني خلط العملات أو إدخال سعر سنوي؟

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

هل تشمل الحسابات الضرائب أو رسوم نقل البيانات؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/dev/api-cost-per-request-estimate

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

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

curl -X POST https://api.kit.forhosting.com/dev/api-cost-per-request-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_plan_cost":100,"included_requests":100000,"actual_requests":125000}'

const res = await fetch("https://api.kit.forhosting.com/dev/api-cost-per-request-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "monthly_plan_cost": 100,
    "included_requests": 100000,
    "actual_requests": 125000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/api-cost-per-request-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "monthly_plan_cost": 100,
    "included_requests": 100000,
    "actual_requests": 125000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/api-cost-per-request-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"monthly_plan_cost":100,"included_requests":100000,"actual_requests":125000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"monthly_plan_cost":100,"included_requests":100000,"actual_requests":125000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/api-cost-per-request-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "monthly_plan_cost": 100,
  "included_requests": 100000,
  "actual_requests": 125000
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_value 1000000000000000

الأخطاء

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

ملاحظات تقنية

قد يبدو اشتراك API منخفض التكلفة إلى أن تُعرض النفقات بوصفها تكلفة لكل طلب جرت معالجته فعلياً. الحساب مجاني في المتصفح، ويكلف الاستدعاء الآلي الناجح $0.002.

احسبوا الاستخدام المشمول والتجاوز والسعر الفعلي

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

استخدموا التقدير لاختيار الخطة وضبط التكلفة الشهرية

قبل شراء خطة API، جرّبوا سيناريوهات لحركة منخفضة ومتوقعة ومرتفعة. ويمكن لسير العمل الآلي استدعاء API الحتمية مقابل $0.002 لكل طلب ناجح، والحصول على الحساب نفسه للمدخلات المتطابقة.

حالات التكامل

اختيار مستوى اشتراك API

قارنوا الاستخدام المتوقع ومخاطر رسوم التجاوز قبل شراء حصة شهرية من الطلبات.

أسئلة تقنية

كيف تُحسب تكلفة API الفعلية لكل طلب؟

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

كيف تُحسب تكلفة الاستخدام الزائد في API؟

يُضرب عدد الطلبات التي تتجاوز الحصة في overage_price_per_request. ولا ينتج عن الاستخدام المساوي للحصة أو الأقل منها أي طلبات زائدة أو تكلفة إضافية.

ماذا يحدث إذا كان حجم الطلبات المشمولة سالباً؟

يفشل الطلب بالرمز invalid_input لأن حصة الطلبات المشمولة لا يمكن أن تكون سالبة.

هل يمكن استخدام أي عملة؟

نعم. الحاسبة محايدة من حيث العملة، لكن يجب أن يستخدم monthly_plan_cost وoverage_price_per_request العملة نفسها وسياق الفوترة نفسه.

ما تكلفة استخدام هذه الحاسبة؟

يمكنكم تشغيلها مجاناً في المتصفح. ويكلف كل طلب آلي ناجح عبر API مبلغ $0.002.

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

شغّل الأداة مجانًا

مثال محلول

من الاشتراك الشهري إلى تكلفة فعلية للوحدة

احسبوا الاستخدام المشمول والتجاوز والسعر الفعلي

استخدموا التقدير لاختيار الخطة وضبط التكلفة الشهرية

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

مراجعة فاتورة المزود الشهرية

إنشاء تنبيهات لميزانية الاستخدام

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

احسبوا الاستخدام المشمول والتجاوز والسعر الفعلي

استخدموا التقدير لاختيار الخطة وضبط التكلفة الشهرية

حالات التكامل

اختيار مستوى اشتراك API

أسئلة تقنية

شكرًا