# JSON إلى سلسلة استعلام

أنشئ سلسلة استعلام URL من كائن JSON. تُرمّز كل قيمة بترميز النسب المئوية، وتستخدم الكائنات المتداخلة صياغة الأقواس مثل filter[status]=open، وتُكتب المصفوفات كمفاتيح متكررة أو بين أقواس أو بفهرس أو كقوائم مفصولة بفواصل. اختر %20 أو + للمسافات بما يتوافق مع الخادم الذي يقرأ URL.

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

### ما تنسيقات المصفوفات المتاحة؟

تُنتج صيغة التكرار ids=1&ids=2، وتُنتج صيغة الأقواس ids[]=1&ids[]=2، وتُنتج صيغة الفهارس ids[0]=1&ids[1]=2، وتُنتج صيغة الفاصلة ids=1,2. ويستخدم URLSearchParams ومعظم عملاء HTTP صيغة التكرار؛ أما PHP وRails فيتوقعان الأقواس أو الفهارس.

### كيف تُكتب الكائنات المتداخلة؟

با تدوين الأقواس: يصبح {"filter": {"status": "open"}} بالشكل filter[status]=open. وتُضاف أقواس أخرى للكائنات الأعمق، مثل a[b][c]=1.

### هل تُكتب المسافات بالشكل %20 أم +؟

كلاهما يعني مسافة في سلسلة استعلام. يُعد %20 صحيحًا في أي جزء من URL، بينما تستخدم نماذج HTML الرمز +. تقبل معظم الخوادم كليهما، لذا اختر ما تستخدمه توثيقات خادمك أو API.

### لماذا تُرمّز الأقواس إلى %5B و%5D؟

الأقواس المربعة محارف محجوزة في عناوين URL، لذا تُرمّز مئويًا افتراضيًا، كما تفعل الدالة http_build_query في PHP ومكتبة qs. فعّل خيار الأقواس المقروءة لإبقائها [ و]، وهو ما تقبله معظم الخوادم أيضًا.

### ما المحارف التي تبقى دون ترميز؟

تبقى الأحرف والأرقام والمحارف - _ . ! ~ * ' ( ) كما هي. أما كل ما عداها، بما في ذلك & و= و# والأحرف غير ASCII، فيُرمّز مئويًا بترميز UTF-8.

### كيف تُمثّل القيم الخالية والقيم المنطقية؟

تُكتب true وfalse والأرقام كنص، مثل active=true. وتصبح null قيمة فارغة، مثل note=.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان 433 أداة لوكلاء الذكاء الاصطناعي عبر خادم MCP واحد.](https://multitaskai.com/ar/?ref=oneclickpro)
