استفاده از فایل های http. در ویژوال استودیو

شما API های خود را در دات نت چگونه تست می کنید؟

در پاسخ معمولا این عناوین رو می شنویم :

• Postman
• Swagger
• Unit testing

اما اگر بدانید روش جدیدی نیز برای تست API های خودمان داریم چه؟!

.NET 8 Web API with default .http file

با استفاده از فایل http. می‌توانیم API‌های دات نت خود را تست کنیم، اگرچه این روش از مدت‌ها قبل موجود بود، اما اخیراً که یک API در NET 8 ایجاد کردم، متوجه آن شدم.

این فایل به طور پیش فرض در دات نت 8 ایجاد می شود. چیزی شبیه به تصویر زیر :

هدف این فایل چیست؟

طبق مستندات مایکروسافت، ویرایشگر فایل http. راهی مناسب برای تست پروژه‌های ASP.NET Core، خصوصا APIها است.

ویرایشگر یک رابط کاربری ارائه می دهد که:

• فایل های http را ایجاد و به روز می کند.
• درخواست های HTTP مشخص شده در فایل های http را ارسال می کند.
• پاسخ ها را نمایش می دهد.

ظاهر این فایل چگونه است؟

به طور پیش فرض این فایل حاوی کد های زیر است:

با استفاده از علامت ات ساین ( @ ) میتوانیم متغیر جدیدی را اضافه کنیم.

سه هشتگ پست سر هم ( ### ) به عنوان جداکننده استفاده می‌شود تا به این فایل بگوییم که API قبلی در اینجا به پایان رسیده است و بعد از آن API دیگری داریم.

چگونه می توانیم درخواست را ارسال کنیم؟

پروژه خود را اجرا کنید و سپس روی Send request کلیک کنید و در سمت راست نتایج درخواست خود را مشاهده کنید.

برای سایر متد های HTTP نیز میتوان از همین طریق، درخواست ها را اضافه کنیم.

• OPTIONS
• GET
• HEAD
• POST
• PUT
• PATCH
• DELETE
• TRACE
• CONNECT

چگونه header و body را اضافه کنیم؟

می‌توانیم هدر را به صورت key: value اضافه کنیم و برای اضافه کردن بدنه می توانیم از پرانتز های باز و بسته {} به شکل زیر استفاده کنیم.

توصیه می کنم برای کسب اطلاعات بیشتر درباره نحوه تنظیم environment file ها، user secret ها و azure key vault مستندات مایکروسافت را بررسی کنید.

ترجمه ای هرچند ناقص اما کار راه انداز با اندکی دخل و تصرف از :

https://mwaseemzakir.substack.com/p/ep-49-use-http-files-in-visual-studio