✅یکی از کمبودهای قدیمی HTTP بالاخره برطرف شد.

😃متد QUERY که تا همین اواخر در حد Draft بود، از ژوئن ۲۰۲۶ رسماً با RFC 10008 استاندارد شد.
اگر با CQRS کار می‌کنید یا سرچ‌های پیچیده (مثل Elasticsearch) دارید، احتمالاً از این خبر خوشتان می‌آید.

⸻

تا امروز برای سرچ‌های پیچیده معمولاً یکی از این دو راه را داشتیم:
GET /search?q=golang&page=1
یا
POST /search
Content-Type: application/json

{
"query": {
...
}
}
هر کدام یک مشکل اساسی داشتند.
⭐️ GET
از نظر HTTP کاملاً مناسب عملیات Read است:
Safe
Idempotent
Cacheable
اما همه پارامترها باید داخل URL قرار بگیرند. برای Queryهای پیچیده، مخصوصاً در Elasticsearch، این روش خیلی زود به بن‌بست می‌رسد.

⸻

⭐️ POST
امکان ارسال Body را می‌دهد و تقریباً همه ما سال‌هاست برای Search از آن استفاده می‌کنیم.
اما از دید پروتکل، POST یک عملیات عمومی است که ممکن است State سرور را تغییر دهد.
در نتیجه:
Cacheها معمولاً آن را Cache نمی‌کنند.
Retry خودکار همیشه منطقی نیست.
از نظر Semantic، برای یک عملیات صرفاً Read انتخاب ایده‌آلی نیست.

⸻

⭐️حالا QUERY آمده تا دقیقاً این مشکل را حل کند.
QUERY /search
Content-Type: application/json

{
"query": {
...
}
}
یعنی:
⭐️ Body دارد.
⭐️ Safe است.
⭐️ Idempotent است.
⭐️ قابلیت Cache شدن دارد.
و مهم‌تر از همه، پروتکل از همان ابتدا می‌داند که این درخواست فقط برای خواندن داده است و هیچ تغییری در State ایجاد نمی‌کند.

⸻

برای طرفداران CQRS این اتفاق واقعاً جذاب است.
قبلاً مجبور بودیم بنویسیم:
POST /orders/search
در حالی که اسم Endpoint می‌گفت Query است، اما Method می‌گفت POST!
حالا می‌توانیم بنویسیم:
QUERY /orders/search
که از نظر Semantic هم کاملاً با معماری CQRS هماهنگ است.

⸻

⭐️البته یک نکته مهم وجود دارد.
هرچند QUERY حالا یک استاندارد رسمی است، اما هنوز بسیاری از Frameworkها، API Gatewayها، Reverse Proxyها، CDNها و ابزارهای مختلف از آن پشتیبانی کامل ندارند.

پس فعلاً احتمالاً همچنان POST /search را زیاد خواهید دید؛ اما به مرور زمان انتظار می‌رود QUERY جایگاه واقعی خودش را پیدا کند.

به نظر من، این یکی از بهترین تغییراتی است که طی سال‌های اخیر به HTTP اضافه شده؛ چون بالاخره برای «عملیات Read با Body» یک راه‌حل استاندارد داریم.

#آنوفل #anophel #http #query #query