ForHosting KIT · التنبيهات وسير العمل

عالج آلاف العناصر في طلب واحد

flow.batch يشغّل المهمة نفسها على قائمة كاملة من العناصر بطلب واحد بدل طلب منفصل لكل واحد. تحقّق من عشرة آلاف آيبان، اقرأ مئة فاتورة، لخّص ألف نص — تُرسِل القائمة عبر الـAPI وتستلم نتيجة كل عنصر معرَّفة بمصدرها، حتى مع فشل بعضها.

● مستقرةلكل طلب · لكل عنصر$0.002

اطّلع على الـAPI — $0.002 اطّلع على الـAPI

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

ألف عنصر، طلب واحد

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

كيف تدخل الدفعة وتخرج

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

العنصر الذي يفشل لا يُسقِط الدفعة

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

كيف تُحسَب تكلفة الدفعة

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

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

مجلد فواتير يتحول إلى جدول واحد

تُقفل مؤسسة النخيل للمقاولات الشهر بمجلد مليء بفواتير الموردين. تقرأ دفعة واحدة الجميع وتعيد جدول بيانات موحّدًا — ما كان محمد الحربي يفتحه ملفًا تلو الآخر يخرج الآن بطلب واحد.

عشرة آلاف آيبان تُفحَص دفعة واحدة

تحتاج مؤسسة مالية التحقق من عشرة آلاف آيبان سعودي في قاعدة بيانات قديمة قبل حملة تحصيل. تفحص الدفعة القائمة كاملة وتُعلّم غير الصالح، بدل عشرة آلاف فحص يدوي.

إيصالات الأسبوع تُقرأ معًا

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

مئتا تعليق مُلخَّص

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

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

ما الفرق بين الدفعة والتشغيل المتوازي؟

التوازي يشغّل عددًا من المهام المختلفة في الوقت نفسه؛ الدفعة تشغّل المهمة نفسها على قائمة طويلة من العناصر. لآلاف العناصر المتماثلة، الدفعة هي الطريق؛ لعدد قليل من المهام المختلفة، التوازي أنسب.

ماذا لو فشل بعض عناصر القائمة؟

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

كم تكلفة معالجة قائمة؟

$0.002 لطلب الدفعة زائد سعر المهمة على كل عنصر. عشرة آلاف آيبان بسعر $0.002 لكل واحد تعطي $20 مقابل العناصر، والحساب دائمًا مقابل ما عولج فعلًا.

هل يوجد حد لحجم القائمة؟

الدفعة مصمَّمة للقوائم الكبيرة — الآلاف بلا مشكلة. لأحجام أكبر بكثير من ذلك، الأفضل تقسيمها إلى دفعات أو التواصل معنا؛ راسل [email protected] لضبط الطريقة المناسبة.

هل تصل النتائج بالترتيب نفسه للقائمة؟

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

هل تُحفَظ بيانات القائمة؟

تُعالَج القائمة لإنتاج النتائج فقط وهذا غرضها الوحيد. تعود المجموعة إليك؛ الاحتفاظ بالقاعدة مسؤولية نظامك.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/flow/batch

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

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

curl -X POST https://api.kit.forhosting.com/flow/batch \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/flow/batch", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/batch",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/batch", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/batch", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

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

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