query string یعنی چه؟
تلفظ: کوئِری اِسترینگ · نوع: اسم
معنی query string: تکهی بعد از علامت سؤال در نشانی
query یعنی پرسوجو و string یعنی رشتهی متنی. query string تکهای از URL است که بعد از علامت سؤال میآید و جزئیات خواستهات را به سرور میگوید: چه چیزی را جستوجو کن، صفحهی چندم، به چه ترتیب. از جفتهای «اسم=مقدار» ساخته میشود که با & از هم جدا شدهاند. وقتی در یک سایت چیزی جستوجو میکنی، کلمهات را همانجا در نشانی میبینی.
query string در جمله
Add the page number to the query string of the URL.
شمارهی صفحه را به کوئریاسترینگ نشانی اضافه کن.
query string در کد
https://example.com/search?q=python&page=2
requests.get("https://example.com/search", params={"q": "python", "page": 2})در requests با params همان کوئریاسترینگ ساخته میشود؛ لازم نیست دستی بنویسی.
نکته
به هر جفت میگویند query parameter. فاصله و حروف فارسی در نشانی کدگذاری میشوند؛ مثلاً فاصله میشود %20.
کلمههای مرتبط
- URL: نشانی کامل یک چیز در وب
- GET request: درخواستی که فقط چیزی را میگیرد
- parameter: پارامتر؛ اسم ورودی در تعریف تابع
درس این کلمه
query string یکی از هشت کلمهی درس «API» در فاز 4: وب و API از دورهی انگلیسی برای برنامهنویسها است. بقیهی کلمههای این درس:
- API: راه رسمی حرف زدن یک برنامه با برنامهی دیگر
- endpoint: نشانی یک کار مشخص در API
- REST: سبکی ساده و رایج برای ساختن API روی HTTP
- JSON: قالبی متنی و ساده برای نوشتن و فرستادن داده
- XML: قالبی تگدار برای نوشتن داده، قدیمیتر از JSON
- payload: بار اصلی پیام؛ دادهای که واقعاً میفرستی
- resource: منبع؛ هر چیزی که API به تو میدهد یا نگه میدارد