Importing (cURL, OpenAPI/Swagger) in Postman

جمعبندی آزمونی سرفصل

Importing چیست؟

Importing در Postman یعنی وارد کردن APIها یا Requestها از منابع خارجی به داخل Postman برای تست، مدیریت و اجرای سریعتر.

این قابلیت باعث میشود به جای ساخت دستی Requestها، آنها را از منابع استاندارد وارد کنیم.

انواع Import در Postman

1. Import cURL

در این حالت یک cURL command به Postman تبدیل میشود.

مثال:

curl -X GET "https://api.com/customers/1" \
-H "Authorization: Bearer token"

نتیجه در Postman:

• Method: GET

• URL: /customers/1

• Header: Authorization

کاربرد:

• تبدیل سریع command به request

• Debugging

• Reproduce API calls

• تست API بدون نوشتن دستی

نکته مهم آزمونی:

👉 cURL = Raw HTTP Request → Postman = Visual Request

2. Import OpenAPI / Swagger

در این حالت یک API Contract کامل وارد Postman میشود.

فرمتها:

• JSON

• YAML

مثال ساختار OpenAPI:

paths:
  /customers:
    get:
      summary: Get customers

در Postman چه اتفاقی میافتد؟

• تمام endpoints ساخته میشوند

• methods (GET, POST, …) اضافه میشوند

• schema و parameters وارد میشوند

• documentation قابل استفاده میشود

کاربرد:

• تست API بدون نیاز به دستی ساختن request

• Contract-based testing

• Integration با تیم backend

• کاهش خطای انسانی

Import Flow در Postman

مراحل:

1. Import Button

2. انتخاب:

   • cURL

   • File (Swagger JSON/YAML)

   • Link

3. Parse

4. Generate Collection

5. Ready for Testing

نکات مهم آزمونی (L7 → L8)

1. Contract-first Testing

Swagger → تعریف Contract → تست مستقیم API

2. cURL = Real-world Debug Tool

• سریع

• بدون UI

• مناسب troubleshooting

3. Swagger Import Advantage

• Auto-generated tests

• Consistency with backend

• Schema validation base

4. Risk in Importing

• outdated swagger → false test cases

• incomplete cURL → missing headers/body

• mismatch between spec and implementation

5. Testing Strategy

Backend Tester باید بررسی کند:

• آیا Swagger با API واقعی match است؟

• آیا imported requests قابل اجرا هستند؟

• آیا schema صحیح آمده؟

• آیا authentication درست منتقل شده؟

خطاهای رایج در آزمون

• import ناقص cURL (missing -H / -d)

• swagger قدیمی

• mismatch بین endpoint و implementation

• نبود authentication در import

• عدم شناخت schema mapping

نکته امتحانی مهم

در پاسخ کامل باید این کلیدواژهها دیده شوند:

Import, cURL, OpenAPI, Swagger, Contract, Request Generation, Collection, Schema, API Testing, Automation

نمونه پاسخ کامل کوتاه

Importing in Postman فرآیند وارد کردن APIها از منابع خارجی مانند cURL یا OpenAPI/Swagger به داخل Postman است. با Import cURL، یک HTTP request به صورت مستقیم به Postman تبدیل میشود، در حالی که Import Swagger/OpenAPI یک مجموعه کامل از endpoints و schemaها را بر اساس Contract ایجاد میکند. این قابلیت برای تست سریع، کاهش خطا، و اجرای تستهای مبتنی بر Contract استفاده میشود.

کلیدواژهها

Importing cURL OpenAPI Swagger Contract Testing API Specification Schema Collection Generation Request Parsing Automation Testing

Importing (وارد کردن API به Postman): برای تبدیل منابع خارجی به requestهای قابل تست استفاده میشود.

cURL Import (تبدیل command به request): برای debug و اجرای سریع API استفاده میشود.

Swagger/OpenAPI Import (وارد کردن Contract کامل API): برای تولید خودکار مجموعه APIها بر اساس specification استفاده میشود.

جمعبندی ذهنی

Import یعنی:
👉 “از دنیای بیرون، API آماده بیار داخل Postman و سریع تست کن”