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

طريقة توليد JSON Schema من مثال حقيقي

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

● مستقرةلكل طلب · لكل مستند$0.003

تشغيل — $0.003 + $0.0135/مستند اطّلع على الـAPI

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

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

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

لماذا يحتاج نظامك مخططًا

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

من مثال إلى مخطط كامل

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

السعر بالتفصيل

$0.003 لكل طلب زائد $0.0135 لكل مستند مخطط يُولَّد، أي نحو $0.0165 للمخطط الواحد بصرف النظر عن عدد حقوله. توليد خمسة مخططات لخمس نقاط استقبال بيانات مختلفة في نظامك يكلف نحو $0.08 إجمالًا، دون اشتراك شهري ودون حد أدنى للاستخدام. الدفع عبر PayPal، والتواصل المباشر عبر واتساب أو البريد متاح لمن يفضّله. مقارنة بوقت كتابة المخطط يدويًا حقلًا حقلًا، خصوصًا في بيانات معقدة متعددة المستويات، يوفر التوليد الآلي وقتًا يستحق هذا السعر الرمزي.

استخدام المخطط بعد توليده

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

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

تحقق من نموذج ويب قبل القبول

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

توثيق واجهة داخلية بين فريقين

فريق الواجهة الخلفية في مؤسسة النخيل للمقاولات يولّد مخططًا من استجابة API فعلية ويشاركه مع فريق تطبيق الجوال ليعرف الشكل الدقيق المتوقع للبيانات.

فحص بيانات مُستقبَلة من جهة خارجية

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

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

هل تحتاج الأداة الوصول إلى نظامي الفعلي؟

لا، تكتفي بمثال بيانات JSON تلصقه أو ترسله؛ لا اتصال بنظامك أو قاعدة بياناتك في أي خطوة.

ما الفرق بين هذه الأداة وكتابة المخطط يدويًا؟

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

هل تُحفظ عينة البيانات التي أرسلها؟

لا، تُستخدم لإنتاج المخطط فقط ولا تُحفظ بعد اكتمال الطلب.

هل يتعرف المخطط على الحقول الاختيارية؟

نعم، بناءً على الأمثلة المُرفقة؛ كلما تنوعت الأمثلة، ازدادت دقة التمييز بين الإلزامي والاختياري.

كم سعر توليد مخطط واحد؟

نحو $0.0165 للمخطط الواحد: $0.003 للطلب زائد $0.0135 للمستند.

هل يدعم المخطط الكائنات المتداخلة؟

نعم، يحلل الكائنات والمصفوفات المتداخلة داخل المثال ويبني مخططًا متعدد المستويات يعكس بنيتها الفعلية.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/dev/json-schema-gen

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

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

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

const res = await fetch("https://api.kit.forhosting.com/dev/json-schema-gen", {
  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/dev/json-schema-gen",
    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/dev/json-schema-gen", 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/dev/json-schema-gen", 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": "dev.json_schema_gen",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

الأسعار

لكل طلب$0.003

لكل مستند$0.0135

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

الأخطاء

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

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