كيفية استخدام منشئ حمولات API
- أضف الحقول مع مساراتها وقيمها (أو الصق JSON أساسياً أولاً).
- اختر التحديد التلقائي للأنواع أو السلاسل النصية فقط، وصيغة الإخراج.
- انسخ المتن وترويسة Content-Type إلى طلبك.
مزايا منشئ حمولات API
- محرّر حقول يدعم المسارات المنقوطة (customer.address.city) وفهارس المصفوفات (items[0].sku وtags[])
- تحديد أنواع القيم تلقائياً: الأعداد والقيم المنطقية وnull ومصفوفات JSON وكائناته — أو فرض السلاسل النصية
- دمج عميق فوق مستند JSON أساسي اختياري
- إخراج بصيغة JSON منسّقة أو مصغّرة أو application/x-www-form-urlencoded أو multipart/form-data مع ترويسة Content-Type المطابقة
- شجرة البنية وإحصاءات الحمولة (الحجم والحقول والعمق والمصفوفات وقيم null)
- حماية من فقدان الدقة في الأعداد الصحيحة الكبيرة جداً
مثال على منشئ حمولات API
إنشاء حمولة طلب شراء
الإدخال:
customer.name = Layla Hassan · items[0].sku = KB-100 · items[0].qty = 2 · notify = true · coupon = nullالنتيجة:
{
"customer": { "name": "Layla Hassan" },
"items": [{ "sku": "KB-100", "qty": 2 }],
"notify": true,
"coupon": null
}
Content-Type: application/jsonالأسئلة الشائعة حول منشئ حمولات API
كيف أنشئ كائنات ومصفوفات متداخلة؟
استخدم المسارات المنقوطة للكائنات (customer.address.city) والفهارس أو [] للمصفوفات (items[0].sku وtags[]). تبني الأداة البنية نيابةً عنك وتعرضها على شكل شجرة.
كيف تُحدَّد أنواع القيم؟
في الوضع التلقائي يصبح 42 عدداً، وtrue/false قيمتين منطقيتين، وnull قيمة null في JSON، وأي قيمة تبدأ بـ [ أو { ويمكن تحليلها تُضمَّن بوصفها JSON. ضع القيمة بين علامتي اقتباس مزدوجتين لفرضها سلسلة نصية، أو بدّل إلى «الكل كسلاسل نصية».
ما فائدة حقل «JSON الأساسي»؟
الصق حمولة موجودة (من التوثيق أو من طلب سابق)، فتُدمج الحقول التي تضيفها دمجاً عميقاً فوقها، بحيث لا تعدّل إلا ما يتغيّر.
كيف يبدو إخراج النماذج وmultipart؟
يسطّح application/x-www-form-urlencoded القيم المتداخلة باستخدام ترميز الأقواس؛ وينتج multipart/form-data المتن المفصول بحدود (boundary) بجزء لكل حقل (القيم المتداخلة كأجزاء JSON). ويأتي كلا الإخراجين مع ترويسة Content-Type المطابقة.