محلل سلسلة الاستعلام
تنقسم name=Ada&city=New%20York&q=hello+world إلى ثلاثة أزواج: name Ada وcity New York وq hello world. حلّل سلسلة الاستعلام إلى أسماء وقيم مرتبة، أو ابنِ من أزواجك سلسلة مرمّزة بشكل صحيح. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
تعمل هذه الأداة داخل متصفحك — مجانًا، ولا تُرسل بياناتك إلى أي خادم
تحمل سلاسل استعلام URL المرشحات ووسوم الحملات والترقيم وحقول النماذج بعد علامة الاستفهام في العنوان. قراءتها يدويًا عرضة للأخطاء: قد تظهر المسافات كعلامات زائد أو percent-twenty، وتفصل علامات العطف الحقول، ويفصل التساوي الأسماء عن القيم، وقد يفسد تهريب مئوي معطوب سطر السجل بأكمله. يحوّل محلل سلسلة الاستعلام هذا في الاتجاهين بعقد واحد. يقبل وضع parse استعلامًا خامًا (مع علامة استفهام بادئة أو بدونها)، ويفك ترميز كل مفتاح وقيمة، ويعيد قائمة مرتبة من الأزواج مع خريطة كائن بسيطة للمفاتيح الفريدة. يقبل وضع serialize الأزواج نفسها أو خريطة كائن مسطحة ويُخرج سلسلة استعلام مرمّزة بالمئة بشكل صحيح جاهزة للإلحاق بعد المسار.
كيف ترمّز سلاسل الاستعلام أزواج المفتاح والقيمة
يبدو جزء استعلام نموذجي مثل name equals Ada ampersand city equals New percent-twenty York. علامة العطف هي فاصل الحقول؛ وأول تساوٍ في كل حقل يفصل اسم المعامل عن قيمته. تُرمَّز القيم (وأحيانًا الأسماء) بالمئة حتى تصمد المسافات وعلامات العطف والحروف غير ASCII والمحارف المحجوزة عبر المتصفحات والوكلاء وأدوات التحليل.
تعامل خوادم كثيرة الزائد العاري كمسافة وفق قواعد application/x-www-form-urlencoded لنماذج HTML؛ وتفعل هذه القدرة ذلك افتراضيًا عند التحليل، ويمكنكم تعطيله إذا احتجتم زائدًا حرفيًا. تُتخطى الحقول الفارغة من علامات عطف ختامية أو مزدوجة حتى لا تُختلق مفاتيح شبح فارغة. يُعامل المعامل بلا علامة تساوٍ كمفتاح بقيمة سلسلة فارغة، كما في مكتبات الخوادم الشائعة.
عندما يظهر المفتاح نفسه أكثر من مرة، تُحفظ كل واقعة في قائمة الأزواج المرتبة حتى لا تُفقد مرشحات الاختيار المتعدد أو الوسوم المكررة؛ وتستخدم خريطة الكائن المرافقة last-wins ليحصل العملاء البسيطون على قاموس مسطح. يستخدم الترميز encodeURIComponent على كل مفتاح وقيمة حتى لا تتسرب الفواصل المحجوزة إلى السلسلة المُجمَّعة.
أين يثبت محلل سلسلة الاستعلام جدواه
تحتاج خدمات الخلفية التي تسجّل الطلبات الواردة طريقة موثوقة لتحويل جزء البحث من URL إلى حقول منظمة للمقاييس وأدوات الدعم دون كتابة مقسّم لمرة واحدة يسيء التعامل مع علامات الزائد أو Unicode. وتحتاج تطبيقات الواجهة التي تعيد بناء رقائق المرشح من search للموقع الحالي أزواجًا مرتبة حتى تصمد الأوجه متعددة القيم ذهابًا وإيابًا عبر encode وdecode. تقارن مسارات QA وCI متجهات استعلام ذهبية عبر Node والمتصفحات حتى تكون المسافة دائمًا percent-twenty عند الترميز ويظل الزائد في إدخال بأسلوب النموذج مسافة عند التحليل.
تلصق فرق الدعم روابط نصف مرمّزة من التذاكر وتحتاج فاكًّا يفشل بصراحة عند التهريبات المقطوعة بدل اختراع محارف. تستفيد مواقع المحتوى التي تترتب على محلل سلسلة الاستعلام من ودجت حي يطابق مساره المجاني في المتصفح مسار الأتمتة المدفوع بايتًا بايت على الوحدة النقية نفسها. يريد مؤلفو المناهج الذين يعلّمون أسس الويب صفحة هبوط مخصصة لقراءة وكتابة معاملات الاستعلام بدل دفن الموضوع تحت مرمّز مئوي عام أو باني UTM، لأن نية البحث تختلف: من يبحث عن محلل سلسلة استعلام يريد البنية لا مجرد تهريب المحارف.
فشل التحقق لا يستهلك الرصيد. أبقوا الطلبات ضمن حدود الطول الموثقة، وثبّتوا الأزواج المرتبة في الاختبارات، فتحصلون على خرائط معاملات قابلة لإعادة الإنتاج للوحات التحكم وإضافات LMS وعمال الحافة دون بناء مجموعة أدوات URL كاملة بأنفسكم.
حالات الاستخدام
فحص معاملات URL الواردة
حلّلوا سلاسل استعلام الطلبات إلى أزواج مفتاح-قيمة مرتبة للسجلات والدعم والتحليلات دون إساءة التعامل مع علامات الزائد أو التهريب المئوي.
بناء سلاسل استعلام صادرة آمنة
سلسلوا المرشحات والوسوم وحقول النماذج إلى سلسلة استعلام مرمّزة بالمئة بشكل صحيح حتى لا تختلق المحارف المحجوزة معاملات إضافية.
اختبارات الذهاب والإياب والثوابت
ولّدوا متجهات ذهبية ل parse وserialize ل CI حتى تبقى المفاتيح متعددة القيم وقيم Unicode مستقرة عبر بيئات التشغيل.
الأسئلة الشائعة
كيف أحلّل سلسلة استعلام URL إلى أزواج مفتاح-قيمة؟
اضبطوا mode على parse (أو احذفوه) وأرسلوا text بجزء الاستعلام مع ? بادئة أو بدونها.
كيف أسلسل الأزواج إلى سلسلة استعلام؟
تتضمن الاستجابة encoded (وquery) مع كل اسم وقيمة مرمّزين بالمئة ومربوطين ب &.
هل تُقرأ علامة الجمع على أنها مسافة؟
نعم افتراضيًا، لأن نماذج الويب ترسل المسافات علامات جمع، فتصبح hello+world هي hello world. ويمكنك إيقاف ذلك عندما تحتاج إلى إبقاء علامة الجمع كما هي.
ماذا يحدث إذا ظهر الاسم نفسه مرتين؟
تُحفظ كل المرات بترتيبها، حتى لا تضيع عوامل التصفية متعددة الاختيار ولا الوسوم المكررة. أما العرض البسيط للاسم والقيمة فيحتفظ بآخر قيمة لكل اسم فقط.
ماذا يحدث مع تسلسل نسبة مئوية تالف؟
يتوقف التحليل برسالة تحدد موضع المشكلة. وتُرفض علامة النسبة المنفردة في النهاية أو المتبوعة بمحارف ليست ست عشرية، بدل فكها جزئيًا.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/query-string \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"mode":"parse","op":"parse"}'const res = await fetch("https://api.kit.forhosting.com/enc/query-string", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"mode": "parse",
"op": "parse"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/query-string",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"mode": "parse",
"op": "parse"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/query-string", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"mode":"parse","op":"parse"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"mode":"parse","op":"parse"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/query-string", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"mode": "parse",
"op": "parse"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.query_string",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تفشل التسلسلات المئوية غير السليمة ب invalid_input بدلًا من بيانات نصف مفكوكة. يشارك ودجت المتصفح المجاني وواجهة API وحدة نقية واحدة بحيث تتوافق العروض والنصوص وخطافات الإنتاج دائمًا.
كيف ترمّز سلاسل الاستعلام أزواج المفتاح والقيمة
يتحقق فك الترميز من كل تسلسل مئوي قبل فك الترميز على المضيف: نسبة مئوية نهائية وحدها أو أرقام غير سداسية عشرية بعد نسبة ترفع invalid_input برسالة واعية بالموضع. المسار عمل سلاسل نقي بلا شبكة ولا بذور عشوائية ولا طوابع ساعة، فمدخلات متطابقة تنتج دائمًا JSON متطابقًا. تسعير API للنداءات الناجحة هو الأساس المنشور $0.002 لكل عنصر، وفشل التحقق لا يستهلك الرصيد المدفوع مسبقًا.
عقد الإدخال وشكل الاستجابة وسلوك الخطأ
فشل التحقق لا يستهلك الرصيد المدفوع مسبقًا. تشمل الفحوصات الكلاسيكية تحليل name equals Ada ampersand city equals New percent-twenty York وتسلسل أزواج تحوي مسافات وعلامات عطف ورفض قيمة تنتهي بنسبة مئوية عارية. وصّلوا نموذج المتصفح المجاني للفحوص السريعة، ثم استدعوا العقد نفسه من النصوص البرمجية عند الحاجة إلى تحضير معاملات جماعي أو ثوابت انحدار. أرسلوا جسم JSON مع mode مضبوطًا على parse أو serialize. للتحليل، قدّموا text (أسماء بديلة query وquery_string وqs) يحوي جزء الاستعلام. تُزال علامة استفهام بادئة اختيارية؛ ويُتجاهل جزء الهاش بعد الاستعلام حتى يعمل لصق بحث كامل من المتصفح. plus_as_space الاختياري يساوي true افتراضيًا لتحويل الزائد إلى مسافة بأسلوب form-urlencoded. عند النجاح يعيد parse القيم mode وplus_as_space وtext الأصلي وعرض query مُطبَّعًا وpairs كمصفوفة سلاسل key وvalue بالترتيب وobject كخريطة last-wins للمفاتيح الفريدة وcount كعدد الأزواج وencoded كسلسلة مُعاد تسلسلها من تلك الأزواج لمقارنة الذهاب والإياب. للتسلسل قدّموا pairs كمصفوفة كائنات بحقول key وvalue أو كخريطة كائن مسطحة. عند النجاح يعيد serialize القيم mode وplus_as_space وpairs المطبّعة وobject وcount وencoded وquery (السلسلة المرمّزة نفسها بلا علامة استفهام بادئة). غياب text في وضع parse وغياب pairs في وضع serialize وقيم mode غير المدعومة والكائنات المتداخلة داخل خريطة والسلاسل الزائدة الطول والتسلسلات المئوية غير السليمة تفشل كلها ب invalid_input ورسالة إنجليزية واضحة. تسعير API الناجح هو الأساس المنشور $0.002 لكل عنصر.
أين يثبت محلل سلسلة الاستعلام جدواه
ولأن التنفيذ parse نقي من المستوى A، تكلف كل نداء ناجح السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.
أسئلة تقنية
هل تُعامل علامات الزائد كمسافات؟
نعم افتراضيًا عند التحليل (application/x-www-form-urlencoded). اضبطوا plus_as_space على false إذا احتجتم الإبقاء على + حرفيًا قبل فك الترميز المئوي.
ماذا يحدث إذا كان التسلسل المئوي غير سليم؟
يفشل parse ب invalid_input مع تسمية المعامل والتهريب السيئ (مثل % غير مكتمل أو أرقام غير سداسية عشرية). فشل التحقق لا يُفوتر.
كم يكلف محلل سلسلة الاستعلام؟
أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل نداء ناجح؛ والإدخال غير الصالح لا يُحاسب.