یک مرجع قابل مرور برای هر متد درخواست HTTP — GET، POST، PUT، PATCH، DELETE و بقیه، به علاوه WebDAV — که در یک نگاه نشان می‌دهد هر کدام امن، خودتوان و قابل کش هستند یا نه، آیا بدنه می‌گیرند، و یک نمونهٔ معمول. در مرورگر، رایگان.

هر متد استاندارد درخواست HTTP و معناشناسی آن، کنار هم. همه‌چیز در مرورگر شما از یک مرجع داخلی اجرا می‌شود — چیزی به سرور ارسال نمی‌شود.

متد هدف امن خودتوان قابل کش بدنه کاربرد معمول
هیچ متدی با جستجوی شما مطابقت ندارد.
یک نام یا اصطلاح دیگر را امتحان کنید — مثلاً PATCH، idempotent یا cache.
بله خیر مشروط اختیاری ناپسند

درباره متدهای HTTP

این مرجع متدهای HTTP هر متد درخواست استاندارد؛ GET، HEAD، POST، PUT، PATCH، DELETE، CONNECT، OPTIONS و TRACE؛ به‌علاوه افزونه‌های رایج WebDAV را در یک جدول قابل مرور جمع می‌کند. برای هر متد به پرسش‌هایی که توسعه‌دهندگان واقعاً به آن‌ها فکر می‌کنند پاسخ می‌دهد: آیا امن است، آیا ایدم‌پوتنت است، آیا قابل کش است، آیا بدنه درخواست دارد، و یک استفاده معمولی چه شکلی است.

این سه ویژگی معنایی، تصمیمات طراحی واقعی را هدایت می‌کنند. متدهای امن فقط‌خواندنی هستند و می‌توانند آزادانه پیش‌واکشی شوند؛ متدهای ایدم‌پوتنت را می‌توان پس از خرابی شبکه بدون عوارض جانبی دوباره تلاش کرد که دقیقاً همان چیزی است که پراکسی‌ها و کلاینت‌های HTTP فرض می‌کنند؛ و قابلیت کش تعیین می‌کند که آیا پاسخ‌ها می‌توانند ذخیره و دوباره استفاده شوند.

جستجو با نام متدها، ویژگی‌ها و موارد استفاده مطابقت دارد؛ PATCH، idempotent و cache همگی جدول را فیلتر می‌کنند؛ و یک کلید گروهی، متدهای استاندارد را از مجموعه WebDAV جدا می‌کند. نام هر متد با یک کلیک در کلیپ‌بورد کپی می‌شود.

نحوه استفاده از متدهای HTTP

  1. جدول را بررسی کنید تا متدها را در ستون‌های Safe، Idempotent، Cacheable و Body مقایسه کنید.
  2. بر اساس نام، ویژگی یا مورد استفاده جستجو کنید؛ برای مثال PUT، idempotent یا upload.
  3. بین گروه‌های Standard و WebDAV جابه‌جا شوید تا متدهای افزونه را شامل یا حذف کنید.
  4. روی راهنمای ستون‌ها نگه دارید تا تعریفی ساده از هر ویژگی ببینید.
  5. روی دکمه کپی کلیک کنید تا نام یک متد را برای مشخصات API یا تست خود بردارید.

سوالات متداول

امن یعنی درخواست اصلاً وضعیت سرور را تغییر نمی‌دهد؛ GET و HEAD فقط‌خواندنی هستند. ایدم‌پوتنت یعنی تکرار همان درخواست همان اثر یک‌بار ارسال آن را دارد؛ DELETE ایدم‌پوتنت است اما امن نیست، چون همان فراخوانی اول واقعاً وضعیت را تغییر می‌دهد.

PUT کل منبع را با بدنه‌ای که ارسال می‌کنید جایگزین می‌کند و ایدم‌پوتنت است. PATCH یک اصلاح جزئی اعمال می‌کند؛ فقط فیلدهایی که شامل می‌کنید تغییر می‌کنند؛ و ایدم‌پوتنت بودنش تضمین‌شده نیست. از PUT برای جایگزینی کامل و از PATCH برای به‌روزرسانی هدفمند استفاده کنید.

چون کلاینت‌ها، پراکسی‌ها و SDKها به‌طور خودکار درخواست‌های ایدم‌پوتنت را پس از تایم‌اوت یا قطع اتصال دوباره تلاش می‌کنند. یک POST غیر-ایدم‌پوتنت که کورکورانه دوباره تلاش شود می‌تواند سفارش‌ها یا رکوردهای تکراری ایجاد کند؛ به همین دلیل APIهای پرداخت، POST را با کلیدهای ایدم‌پوتنسی جفت می‌کنند.

پاسخ‌های GET و HEAD به‌طور پیش‌فرض قابل کش هستند. پاسخ‌های POST تنها زمانی ممکن است کش شوند که هدرهای صراحت تازگی اجازه دهند، که در عمل نادر است. متدهای دیگر قابل کش نیستند؛ پاسخ‌های آن‌ها نباید ذخیره و دوباره استفاده شوند.

WebDAV، HTTP را برای مدیریت فایل از راه دور گسترش می‌دهد و متدهایی مانند PROPFIND، MKCOL، COPY، MOVE، LOCK و UNLOCK را اضافه می‌کند. هنگام کار با سرورهای WebDAV، پروتکل‌های تقویم/مخاطب ساخته‌شده روی آن‌ها، یا یکپارچه‌سازی درایو شبکه با آن‌ها روبه‌رو می‌شوید.

بله. کل جدول رایگان است و در مرورگر شما از یک مجموعه‌داده داخلی اجرا می‌شود؛ جستجو و فیلترکردن چیزی به سرور ارسال نمی‌کنند.

اشتراک‌گذاری
به کمک نیاز دارید؟
با این ابزار مشکلی پیدا کردید؟ به تیم ما اطلاع دهید.
گزارش مشکل

این ابزار رایگان را به وب‌سایت خود اضافه کنید — کد زیر را کپی و جای‌گذاری کنید.