QUERY معرفی شده که یک سری از مشکلات رو حل میکنهمتد
QUERY برای ارسال درخواستهای جستجو یا فیلتر پیچیده به سرور طراحی شده است. از نظر کاربرد شبیه POST است، اما یک تفاوت مهم دارد:- نباید دادهای روی سرور تغییر دهد.
- اگر چند بار همان درخواست ارسال شود، نتیجه یکسان خواهد بود.
معمولاً جستجوها با
GET یا POST انجام میشوند:GET /products?category=laptop&brand=dell&price<1000
اما وقتی فیلترها یا شرایط جستجو خیلی بزرگ و پیچیده شوند، قرار دادن همه اطلاعات در URL مشکلساز میشود. متد
QUERY اجازه میدهد اطلاعات جستجو در بدنه (Body) درخواست ارسال شوند.QUERY /products HTTP/1.1
Host: example.com
Content-Type: application/json
{
"category": "laptop",
"brand": "Dell",
"maxPrice": 1000
}
سرور نتیجه جستجو را برمیگرداند، بدون اینکه وضعیت یا دادهای را تغییر دهد.
متد
QUERY در ژوئن ۲۰۲۶ به عنوان RFC 10008 استاندارد شده است، اما هنوز همه وبسرورها، فریمورکها و API Gatewayها از آن پشتیبانی نمیکنند. بنابراین در بسیاری از APIها هنوز از GET یا POST برای عملیات جستجو استفاده میشود.@AmirhDeveloper
.