در قسمت دوم ، از متغیرهای سراسری، برای ایجاد یک گردش کاری بین دو درخواست ارسالی، استفاده کردیم. در این قسمت میخواهیم با انواع متغیرهای قابل تعریف در Postman آشنا شویم.
متغیرهای سراسری در Postman
برای تعریف متغیرهای سراسری که در تمام برگههای Postman قابل دسترسی باشند، میتوان از متد pm.globals.set در قسمت Tests هر درخواست که پس از پایان درخواست جار ...
اسکریپت و آزمون نویسی مقدماتی با Postman را در قسمت دوم بررسی کردیم. در این قسمت نکات و امکانات پیشرفتهتری را در این مورد مرور خواهیم کرد.
بررسی اجزای اولین آزمایش با Postman
آزمونهای Postman، عموما یک سری Assertion هستند؛ به این معنا که در آنها، مقداری از Response دریافتی از سرور را با مقداری مشخص و مورد انتظار، مقایسه میکنیم: p ...
تا اینجا ، یک دید کلی را نسبت به postman و توانمندیهای آن پیدا کردهایم. در ادامه قصد داریم، تعدادی نکتهی تکمیلی مهم را که در حین ساخت درخواستها در postman، به آنها نیاز پیدا خواهیم کرد، بررسی کنیم.
ایجاد یک request bin جدید
برای مشاهدهی محتوای ارسالی توسط postman بدون برپایی وب سرویس خاصی، از سایت requestbin استفاده خواهیم کرد. در اینجا با کلیک بر روی دکمهی create a request bin، یک آدرس موقتی را مانند ht ...
تا اینجا مثالهایی را که بررسی کردیم، متکی به خود بودند و اطلاعات هر کدام، از یک درخواست به درخواستی دیگر کاملا متفاوت بود. همچنین اطلاعات ارسالی و یا دریافتی توسط آنها نیز ثابت و از پیش تعیین شده بود.
کار با اطلاعات متغیر دریافتی از سرور
در Postman یک برگهی جدید را باز کنید و سپس آدرس https://httpbin.org/uuid را در حالت Get درخواست نمائید:
این درخواست، یک Guid اتفاقی جدید را باز میگرد ...
Postman یک ابزار متکی به خود چند سکویی، رایگان و فوق العادهای است جهت توسعه و آزمایش Web APIها (HTTP Restful APIs). برای دریافت آن میتوانید به این آدرس مراجعه کنید. البته پیشتر افزونهای، مخصوص کروم را نیز ارائه کرده بودند که دیگر پشتیبانی نمیشود و اگر بر روی مرورگر شما نصب است، بهتر است آنرا حذف کنید.
شروع به کار با Postman
پس از نصب و اجرای Postman، در ابتدا درخواست میکند که اکانتی را در سایت آنها ایجاد ...
در سری « مستند سازی ASP.NET Core 2x API توسط OpenAPI Swagger » با نحوهی تولید OpenAPI Specification، بر اساس کنترلرها و اکشن متدهای Web API خود آشنا شدیم و سپس با استفاده از ابزار Swagger-UI، یک رابط کاربری پویا را نیز برای آن تولید و سفارشی سازی کردیم. کاربرد OpenAPI Specification صرفا به مستندسازی یک Web API خلاصه نمیشود. بر اساس این استاندارد، ابزارهای متعددی جهت تولید کدهای سمت سرور و سمت کلاینت نیز طراحی شدهاند که در اینجا نمونهای ...
امکان کنترل کامل و سفارشی سازی ظاهر نهایی Swagger-UI وجود دارد که جزئیات آنرا در این قسمت بررسی خواهیم کرد. بهبود ظاهر کامنتها با بکارگیری Markdown
Markdown زبان سبکی است برای تعیین شیوهنامهی نمایش متون ساده. اگر پیشتر با سیستم ارسال نظرات Github و یا Stackoverflow کار کرده باشید، قطعا با آن آشنایی دارید. توضیحات کامل و جزئیات آنرا میتوانید در آدرس markdownguide.org مطالعه کنید. خوشبختانه امکان استفادهی از Mark ...
ممکن است تعدادی از اکشن متدهای API طراحی شده، محافظت شده باشند. بنابراین OpenAPI Specification تولیدی نیز باید به همراه مستندات کافی در این مورد باشد تا استفاده کنندگان از آن بدانند چگونه باید با آن کار کنند. نگارش سوم OpenAPI Specification از اعتبارسنجی و احراز هویت مبتنی بر هدرها مانند basic و یا bearer، همچنین حالت کار با API Keys مانند هدرها، کوئری استرینگها و کوکیها و یا حالت OAuth2 و OpenID Connect پشتیبانی میکند و این موارد ذیل خ ...
زمانیکه کنترلر یک API را توسط قالبهای پیشفرض آن ایجاد میکنیم، یک سری اکشن متد پیشفرض Get/Post/Put/Delete در آن قابل مشاهده هستند. میتوان این نوع خروجی این نوع متدها را به نحو سادهتری نیز مستند کرد: namespace OpenAPISwaggerDoc.Web.Controllers
{
[Route("api/[controller]")]
[ApiController]
public class ConventionTestsController : ControllerBase
{
// GET: api/ConventionTests/5
[HttpGet("{ ...
Swashbuckle.AspNetCore چگونه اطلاعات خود را فراهم میکند؟
در برنامههای ASP.NET Core، اطلاعات OpenAPI بر اساس سرویس توکاری به نام ApiExplorer تولید میشود که کار آن فراهم آوردن متادیتای مرتبط با یک برنامهی وب است. برای مثال توسط این سرویس میتوان به لیست کنترلرها، متدها و پارامترهای آنها دسترسی یافت. Swashbuckle.AspNetCore به کمک ApiExplorer کار تولید OpenAPI Specification را انجام میدهد. برای فعالسازی این سرویس نیازی نیست ...