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

أرسل webhook فور وقوع الحدث

notify.webhook يوصل تنبيهات بين الأنظمة: حين يقع حدث في نظامك، ترسل الأداة طلب POST إلى نقطة النهاية التي تحددها، بالمحتوى الذي تصممه. تكامل فوري دون طابور خاص ولا عملية معالجة مخصصة تديرها بنفسك — $0.002 لكل عملية تسليم، دفعًا مقابل الاستخدام.

● مستقرةلكل طلب · لكل تسليم$0.002

تشغيل — $0.002 اطّلع على الـAPI

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

شغّلها أونلاين

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

الدفع بدل السؤال المتكرر

دون webhook، يبقى النظام الهدف يسأل «هل حدث شيء؟» كل دقيقة — ما يُعرف بالاستقصاء الدوري، وهو يستهلك طلبات طوال اليوم ليكتشف في النهاية أن لا شيء تغيّر. يقلب webhook الاتجاه: من يعرف بالحدث يُخبر من يحتاج إلى معرفته، في اللحظة نفسها التي يقع فيها. حركة أقل، تأخير أقل، شيفرة تحقق أقل. لتكامل أنظمة لا يعرف أحدها الآخر، هذا هو النمط الذي اعتمدته الشبكة كلها.

كيف تُطلَق عملية التسليم

يحمل الطلب على /notify/webhook عنصرين: عنوان الوجهة ومحتوى JSON الذي تريد تسليمه. تُرسِل الأداة طلب POST، وتُخبرك نتيجة المهمة كيف استجاب الطرف الآخر — رمز HTTP الذي أعادته نقطة النهاية. بذلك تعرف شيفرتك إن وصل التنبيه أو احتاج محاولة أخرى، دون طابور خاص أو اتصال مفتوح دائم. طلب واحد، تسليم واحد، نتيجة يمكن التحقق منها. لا حاجة لفتح منفذ خاص في شبكتك؛ الاتصال يخرج من طرفك نحو الوجهة، لا العكس.

ممارسات جيدة لمن يستقبل

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

السعر لكل تسليم، دون خط دقيق

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

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

طلب جديد يُخبر نظام المحاسبة

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

توظيف مكتمل يُخبر نظام الرواتب

حين تُنهي مؤسسة النخيل للمقاولات إجراءات توظيف موظف جديد، يستلم نظام الرواتب التنبيه ببيانات العقد فورًا. لا تعيد فاطمة الزهراني كتابة البيانات في نظامين منفصلين.

جسر بين نظام جديد ونظام قديم

احتاجت شركة الخليج الرقمية أن يستجيب نظام قديم لأحداث المنتج الجديد دون تعديل الشيفرة القديمة. نقطة نهاية بسيطة في النظام القديم وwebhook من الجديد حلّا المشكلة خلال يوم واحد.

طلب مُشحَن يُخبر شركة النقل

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

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

ما صيغة التنبيه المُسلَّم؟

طلب POST بمحتوى JSON تحدده أنت في الطلب. الوجهة لا تحتاج شيئًا خاصًا: أي نقطة نهاية قادرة على استقبال طلب POST جاهزة للاستخدام.

كيف أعرف أن الوجهة استلمت التنبيه؟

تحمل نتيجة المهمة استجابة نقطة النهاية — رمز HTTP الذي أعادته. الرمز 200 يؤكد التسليم، وأي خطأ يظهر ليقرر نظامك ما يفعله.

ماذا لو كان النظام الهدف متوقفًا عن العمل؟

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

هل يتغير السعر حسب الحجم؟

لا: $0.002 لكل تسليم، ثابتة من التنبيه الأول حتى المليون. عشرة آلاف عملية تسليم تكلّف $20، والحساب واحد قبل النمو وبعده.

هل يُحفَظ محتوى الطلب المُرسَل؟

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

هل أحتاج عقدًا أو حسابًا للاستخدام؟

لا. الشراء مباشر دون تسجيل، والدفع عبر PayPal بالدولار. تربط اليوم وتدفع مقابل ما تستخدمه فقط.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/notify/webhook

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

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

curl -X POST https://api.kit.forhosting.com/notify/webhook \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/notify/webhook", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/notify/webhook",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/webhook", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "input": "…"
}

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

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