در https ، روش های HTTP قرار دادنبا پستوت پچ برای انجام عملیات روی منابع استفاده می شود. در اینجا تمایز اهداف و رفتار آنها آورده شده است:
- پست:
- هدف: برای ایجاد منابع جدید یا ارسال داده به سرور استفاده می شود. این منبع را به یک مجموعه موجود ضمیمه می کند.
- قدرت: idempotent نیست ؛ چندین درخواست پست یکسان یک منابع مختلف ایجاد می کند.
- نمونه: ارسال فرم ثبت نام برای ایجاد کاربر جدید.
-
پاسخ: معمولاً برمی گردد
201 Createdو URI با اشاره به منبع تازه ایجاد شده.
- قرار دادن:
- هدف: برای ایجاد یا جایگزین کردن یک منبع در یک URI خاص استفاده می شود. اگر منبع وجود داشته باشد ، به روز می شود. اگر این کار را نکند ، ایجاد شده است.
- قدرت: idempotent ؛ درخواست های چندگانه یکسان همان نتیجه را تولید می کنند (یعنی همان وضعیت منبع).
- نمونه: به روزرسانی یک نمایه کامل با مجموعه جدیدی از داده ها.
-
پاسخ: به طور معمول برمی گردد
200 OK(در صورت بروزرسانی) یا201 Created(اگر منبع جدید ایجاد شده است).
-
پچ:
- هدف: برای به روزرسانی جزئی یک منبع موجود استفاده می شود. فقط زمینه های ارائه شده در درخواست به روز می شود و بقیه را بدون تغییر می گذارد.
- قدرت: idempotent ؛ چندین درخواست پچ یکسان به همان وضعیت منبع منجر می شود.
- نمونه: به روزرسانی فقط آدرس ایمیل یک نمایه کاربر بدون تغییر زمینه های دیگر.
-
پاسخ: معمولاً برمی گردد
200 OKیا204 No Contentبشر
تفاوت های کلیدی
| روش | عمل | قدرت | مورد استفاده معمولی |
|---|---|---|---|
| پست | منبع جدیدی ایجاد کنید | هیچ | ارسال فرم یا اضافه کردن سوابق به یک پایگاه داده |
| قرار دادن | کل منبع را جایگزین کنید | بله | رونویسی یا ایجاد یک منبع در یک URI خاص |
| پچ | بخشی از یک منبع را به روز کنید | بله | اصلاح زمینه های خاص در یک منبع |
هر روش برای عملیات خاص ، اطمینان از وضوح و سازماندهی مناسب عملیات HTTP طراحی شده است.
