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=.