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

أعد تشكيل بيانات webhook داخل متصفحك

يذهب البريد الموجود في data.customer.email إلى correo والمبلغ 8500 إلى importe، أما المسار غير الموجود فيُحذف ببساطة: صِف الشكل الذي يتوقعه النظام المستقبل لتحصل على الرسالة وقد أُعيد بناؤها على مقاسه. مجاني في متصفحك.

  • مجاني
  • يعمل في متصفحك
  • دون تسجيل
  • بياناتك لا تغادر جهازك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تعمل هذه الأداة داخل متصفحك — مجانًا، ولا تُرسل بياناتك إلى أي خادم

مجانًا وبلا رفع لأي خادم

لماذا نادرًا ما يتفق نظامان على الشكل

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

جدول مطابقة بدل شيفرة مكتوبة يدويًا

تصف الشكل المطلوب بجدول مطابقة، يشير فيه كل اسم في النتيجة إلى المسار المفصول بنقاط حيث توجد قيمته في الرسالة الواردة. ففي المثال يشير correo إلى data.customer.email ويشير importe إلى data.amount، فيصل المبلغ 8500 تحت importe. أما المسار غير الموجود مثل data.no.existe فيُحذف بدل أن يُملأ بقيمة مختلقة. ولإبقاء جدول المطابقة خارج تطبيقك أهمية، فالتحويلات المكتوبة يدويًا داخل التطبيق تُنسى وتنكسر بصمت عندما يغيّر المصدر اسمًا بعد أشهر، بينما يمكن مراجعة جدول مستقل والتحقق منه وحده. وتستطيع خدمة لها عشرات الشركاء أن تحتفظ بجدول لكل شريك وتضيف شريكًا جديدًا دون المساس بالشيفرة المشتركة.

يعمل داخل متصفحك مجانًا

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

هل الاستخدام من الموقع مجاني بلا حدود؟

نعم، من هذه الصفحة الاستخدام مجاني ودون حد على عدد المرات، مهما تكرر خلال اليوم.

هل يدعم تحويل كائنات متداخلة إلى بنية مسطحة؟

نعم، يمكن تحديد قواعد تسطيح للكائنات الفرعية إضافة إلى إعادة تسمية الحقول.

هل يستلزم الاستخدام تسجيل حساب؟

لا، لا توجد حسابات حاليًا؛ الأداة داخل المتصفح تعمل دون تسجيل دخول.

هل يمكن حفظ قواعد التحويل لإعادة استخدامها لاحقًا؟

يمكنك حفظ قواعدك كملف على جهازك وإعادة استيرادها في أي وقت لاحق.

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

يغيب ذلك البند عن النتيجة ببساطة بدل أن يُملأ بقيمة مختلقة. ففي المثال يشير falta إلى data.no.existe غير الموجود في المصدر، لذا لا تحتوي النتيجة إلا على correo وimporte.

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

POSThttps://api.kit.forhosting.com/dev/webhook-transform

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

curl -X POST https://api.kit.forhosting.com/dev/webhook-transform \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payload":{"user":{"name":"Ada"}},"mapping":{"nombre":"user.name"}}'
{
  "payload": {
    "user": {
      "name": "Ada"
    }
  },
  "mapping": {
    "nombre": "user.name"
  }
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.webhook_transform",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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

لماذا تحتاج إعادة تشكيل

بدل كتابة كود تحويل مخصص لكل خدمة جديدة تربطها بنظامك، تعيد الأداة تشكيل البيانات آليًا حسب قواعد تحدّدها أنت مرة واحدة. كل خدمة خارجية — بوابة دفع، نموذج ويب، نظام إشعارات — ترسل بيانات webhook بصيغة JSON خاصة بها، وغالبًا لا يطابق الشكل الذي يتوقعه نظامك الداخلي: حقل اسمه customer_email هناك بينما نظامك يتوقع email، أو بيانات متداخلة في كائن فرعي بينما تحتاج حقولًا مسطحة مباشرة.

يعمل داخل متصفحك مجانًا

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

ربطها بخط أتمتة حقيقي

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

توحيد بيانات من عدة بوابات دفع

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

تسطيح بيانات نموذج معقّد

فريق تقني في شركة الواحة للتجارة المحدودة يستقبل بيانات نموذج تسجيل بكائنات متداخلة، ويسطّحها عبر الـAPI قبل حفظها في جدول واحد بسيط.

اختبار قواعد التحويل قبل النشر

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

هل تُرسَل بيانات webhook إلى خادمكم أثناء الاستخدام من الموقع؟

لا، إعادة التشكيل تجري بالكامل داخل متصفحك؛ البيانات لا تغادر جهازك في أي لحظة.

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

$0.002 لكل حدث عند التنفيذ من جهة الخادم ضمن خط أتمتة حقيقي.

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