پارامترهای REST — Position، Content Type و Constant/Default

14.5. گام «لیست پارامترها» و Request Content Type

پس از تنظیم اطلاعات اصلی سرویس، وارد مرحله تعریف پارامترهای ورودی می‌شوید. در این گام ابتدا «نوع محتوای درخواست» یا Request Content Type مشخص می‌شود. این انتخاب، نحوه ساخت Payload و همچنین گزینه‌های قابل انتخاب برای محل قرارگیری پارامترها را تعیین می‌کند.

• application/json: برای ارسال داده به‌صورت JSON.
• application/json; charset=utf-8: همان JSON با تعیین صریح charset.
• application/x-www-form-urlencoded: برای ارسال داده‌های فرم URL-Encoded.
• multipart/form-data: برای ارسال فایل و فیلدهای همراه آن.

هر ردیف پارامتر ورودی معمولاً شامل این اجزاست:

• نوع داده مانند String، Boolean یا File
• مقدار یا مقدار پیش‌فرض / نمونه
• نام پارامتر
• محل قرارگیری مانند url، header، body یا form-data

14.6. رفتار محل قرارگیری پارامترها (Parameter Location)

محل قرارگیری پارامتر به Content-Type و ماهیت پارامتر وابسته است:

در نمونه‌های تصویری، دیده می‌شود که:

• پارامتر Authorization در header تعریف شده است.
• پارامتر file در سناریوی multipart از نوع File و محل form-data دارد.
• پارامترهای model و language بسته به Content-Type در body یا form-data قرار گرفته‌اند.
• پارامتر rememberMeValue برای پرکردن Query String در محل url ثبت شده است.