Postman CLI
آشنایی با Postman CLI
آخرین بهروزرسانی: 1405-04-15Postman CLI همراه خط فرمان Postman است؛ ابزاری امن، امضاشده و پشتیبانیشده توسط Postman که کمک میکند کارهای مهم Postman را از terminal، CI/CD و محیطهای automation اجرا کنید. اگر با Postman در desktop کار میکنید، Postman CLI همان قابلیتها را برای workflowهای command-line و pipelineها در دسترس قرار میدهد. Postman CLI چه کارهایی انجام...
نصب Postman CLI
آخرین بهروزرسانی: 1405-04-15برای استفاده از Postman CLI، آن را متناسب با سیستمعامل خود نصب کنید. Postman CLI همان system requirementهای Postman desktop app را دنبال میکند. نصب با npm در Windows، macOS و Linux اگر Node.js و npm روی سیستم شما نصب است، سادهترین روش نصب این دستور است: npm install -g postman-cli این دستور binary مربوط...
مرجع commandها و optionهای Postman CLI
آخرین بهروزرسانی: 1405-04-15این صفحه یک نمای کلی از commandها و optionهای Postman CLI است. بعضی commandها به plan حساب Postman شما وابستهاند، اما ساختار کلی CLI بر اساس نوع workflow دستهبندی شده تا سریعتر command مناسب را پیدا کنید. دستههای اصلی commandها Postman CLI commandها را در چند گروه کاربردی قرار میدهد: commandهای پایه postman --help: نمایش...
commandهای پایه Postman CLI
آخرین بهروزرسانی: 1405-04-15commandهای پایه Postman CLI برای گرفتن help، دیدن version و کنترل رفتار خروجی در terminal استفاده میشوند. postman command اصلی CLI همین postman است. آن را با optionهای مختلف اجرا میکنید. Syntax postman [options] Optionها --color <value>: کنترل color output در terminal. مقدارهای قابل قبول auto، on و off هستند. مقدار پیشفرض auto است و...
احراز هویت در Postman CLI
آخرین بهروزرسانی: 1405-04-15در Postman CLI برای ورود و خروج از حساب Postman از commandهای login و logout استفاده میشود. عملیات local بدون login هم قابل انجام است، اما commandهایی که با cloud Postman ارتباط دارند نیاز به ورود دارند. اگر CLI را از شبکهای با outbound restriction اجرا میکنید، باید domainهای لازم Postman را در allowlist قرار...
commandهای workspace در Postman CLI
آخرین بهروزرسانی: 1405-04-15commandهای workspace در Postman CLI برای اعتبارسنجی، sync و push کردن collectionها، environmentها و specificationهای local به workspaceهای Postman در cloud استفاده میشوند. این commandها برای automation در CI/CD و workflowهای Native Git کاربرد دارند. postman workspace prepare این command collectionها و environmentهای local را قبل از push کردن آماده میکند. بررسی میکند IDها UUID...
commandهای collection در Postman CLI
آخرین بهروزرسانی: 1405-04-15این صفحه commandهای مربوط به collection در Postman CLI را توضیح میدهد. با postman collection run میتوانید collection را اجرا کنید، با postman collection migrate collectionهای v2.۱ را به قالب v3 YAML تبدیل کنید، و با postman collection lint سازگاری collection با schema قالب v3 را بررسی کنید. postman collection run این command یک collection...
ارسال request با Postman CLI
آخرین بهروزرسانی: 1405-04-15با command postman request میتوانید یک HTTP request را مستقیم از command line تست و debug کنید. این command بسیاری از قابلیتهای Postman مثل authentication، environment variableها و test scriptها را در CLI در اختیار شما میگذارد. method میتواند GET، POST، PUT، DELETE، PATCH، HEAD یا OPTIONS باشد. اگر method را ننویسید، مقدار پیشفرض GET...
commandهای monitoring و performance در Postman CLI
آخرین بهروزرسانی: 1405-04-15این صفحه commandهای Postman CLI برای monitoring و performance testing را توضیح میدهد. با postman monitor run میتوانید monitor را از pipeline اجرا کنید، با postman runner start runner داخلی سازمان را برای Private API Monitoring راه بیندازید، و با postman performance run performance test را از CI/CD اجرا کنید. postman monitor run این command...
commandهای Application در Postman CLI
آخرین بهروزرسانی: 1405-04-15Application Inventory در planهای Postman Solo، Team و Enterprise در دسترس است. commandهای postman app برای راهاندازی configuration اپلیکیشن، اجرای UI test همراه با network capture، اعتبارسنجی traffic مشاهدهشده در برابر Postman Collectionها و ارسال نتیجه به Application Inventory استفاده میشوند. برای استفاده از این commandها، repository باید به یک workspace در Postman وصل باشد؛...
commandهای Flow در Postman CLI
آخرین بهروزرسانی: 1405-04-15این صفحه commandهای مربوط به Postman Flows در Postman CLI را توضیح میدهد. با این commandها میتوانید flowها را فهرست کنید، flow deploy شده را trigger کنید، flow را deploy یا local اجرا کنید، تنظیمات flow را تغییر دهید و run history را بررسی کنید. postman flows list flowهای موجود در یک workspace را بر...
commandهای API governance در Postman CLI
آخرین بهروزرسانی: 1405-04-15API governance یعنی اعمال یک مجموعه استاندارد مشخص در طراحی و تست API. Postman CLI commandهایی دارد که API specificationهای شما را در Spec Hub با ruleهای governance تیم بررسی میکنند. postman spec lint این command syntax validation و governance rule check را روی یک specification تکفایلی یا چندفایلی در Spec Hub اجرا میکند. specification...
اجرای mock server با Postman CLI
آخرین بهروزرسانی: 1405-04-15این صفحه command مربوط به mock server در Postman CLI را توضیح میدهد. با postman mock run میتوانید یک local mock server را از روی فایل configuration اجرا کنید. postman mock run این command یک local mock server را از فایل configuration با قالب JSON شروع میکند. در این فایل میتوانید مواردی مثل port number،...
commandهای Dataset در Postman CLI
آخرین بهروزرسانی: 1405-04-15Datasetها به شما کمک میکنند data sourceها و viewهای قابل استفاده دوباره را برای workflowهای Postman تعریف کنید. commandهای dataset در Postman CLI برای ساخت و مدیریت dataset، تنظیم data source، اجرای SQL query و اجرای saved viewها استفاده میشوند. در CI/CD میتوانید optionهای --iteration-data-dataset، --iteration-data-view و --dataset را همراه با postman collection run استفاده...
commandهای Webhook در Postman CLI
آخرین بهروزرسانی: 1405-04-15با commandهای postman webhook میتوانید webhookهای یک workspace را از طریق CLI بسازید، فهرست کنید، حذف کنید، status آنها را ببینید، آنها را start یا pause کنید و eventهای دریافتی را به local server خود forward کنید. برای بیشتر این عملیات میتوانید Webhook URL یا Webhook ID را استفاده کنید. برای استفاده از این commandها...
جستجو با Postman CLI
آخرین بهروزرسانی: 1405-04-15با commandهای postman search میتوانید elementهای Postman مثل request، collection، workspace، flow، mock، environment و specification را جستجو کنید و از نتیجه در CI/CD، automation workflowها، scriptها یا agentهای هوش مصنوعی استفاده کنید. برای استفاده از search باید با postman login وارد Postman شده باشید. postman search postman search <type> [query] [options] <type>: نوع element...
اجرای Simulator با Postman CLI
آخرین بهروزرسانی: 1405-04-15Postman Simulator در planهای Solo، Team و Enterprise در دسترس است. با command postman simulate run میتوانید یک local mock server را همراه با simulation اجرا کنید تا ببینید service شما در برابر latency، error، rate limit و constraintهای performance چه رفتاری دارد. postman simulate run این command فایل configuration مربوط به simulator را اجرا...
commandهای SDK در Postman CLI
آخرین بهروزرسانی: 1405-04-15Postman CLI commandهایی برای تولید client SDK از Postman Collectionها و API specificationها دارد. همچنین میتوانید connectionهای GitHub را مدیریت کنید تا بعد از build موفق، pull request بهصورت خودکار ساخته یا update شود. postman sdk init فایل .postman/config.json را برای SDK configuration میسازد یا update میکند. postman sdk init [options] -y یا --yes: promptها...
انتشار نسخههای API با Postman CLI
آخرین بهروزرسانی: 1405-04-15با command postman api publish میتوانید از خط فرمان یک snapshot از نسخه API را در API Builder منتشر کنید. این کار برای تیمهایی مفید است که میخواهند انتشار نسخههای API را در script یا pipeline خودکار کنند. نکته مهم: این command فقط برای API Builder در Postman v11 پشتیبانی میشود. API Builder در Postman...
استفاده از postman context برای agentهای کدنویسی
آخرین بهروزرسانی: 1405-04-15command postman context اطلاعات لازم را برای agentهای کدنویسی مثل Claude Code آماده میکند تا بتوانند درباره APIهای شما دقیقتر کد تولید کنند. این command به agent کمک میکند متد request، URL، headerها، body و workflowهای مرتبط با Postman CLI را بهتر بفهمد. برای استفاده از این command ابتدا با postman login وارد Postman شوید....
اجرای collection با Postman CLI
آخرین بهروزرسانی: 1405-04-15با Postman CLI میتوانید collectionها را از terminal اجرا کنید، نتیجه تستها را ببینید، و در صورت نیاز نتیجه run را به Postman cloud بفرستید. این قابلیت برای اجرای دستی collection و همچنین استفاده در CI/CD pipeline مناسب است. Postman CLI اجرای collectionهای دارای HTTP request را پشتیبانی میکند. در planهای پولی، gRPC و GraphQL...
اجرای monitor با Postman CLI
آخرین بهروزرسانی: 1405-04-15Monitorها برای بررسی منظم سلامت و performance APIها استفاده میشوند. با Postman CLI میتوانید اجرای monitor را از داخل CI/CD pipeline trigger کنید تا قبل یا بعد از deploy، تستهای Postman بهصورت خودکار regression و مشکلهای configuration را پیدا کنند. Postman Monitors از HTTP collectionها پشتیبانی میکند و برای multi-protocol collectionها قابل استفاده نیست. برای...
پیکربندی و اجرای performance test با Postman CLI
آخرین بهروزرسانی: 1405-04-15با performance test میتوانید رفتار API را زیر فشار و ترافیک شبیهسازیشده بررسی کنید. Postman CLI با command postman performance run کمک میکند performance testهای collection را local اجرا کنید یا آنها را به CI/CD pipeline اضافه کنید تا regressionهای performance زودتر پیدا شوند. برای استفاده از این command باید با postman login وارد Postman...
ساخت report برای collection run با Postman CLI
آخرین بهروزرسانی: 1405-04-15Postman CLI چند reporter داخلی دارد که برای collection run گزارش میسازند. reporterهای موجود شامل CLI، JSON، JUnit و HTML هستند. میتوانید فقط یک reporter یا چند reporter را همزمان استفاده کنید و خروجی را مطابق نیاز تیم تنظیم کنید. همه reporterهای داخلی برای HTTP collectionهای v2 با قالب JSON در دسترس هستند. برای HTTP،...
اجرای Postman CLI در GitHub Actions
آخرین بهروزرسانی: 1405-04-15با Postman CLI GitHub Action میتوانید commandهای Postman CLI را مستقیم داخل workflowهای GitHub CI/CD اجرا کنید. این action برای collection run، monitor run، syntax check، governance validation و کارهای مشابه کاربرد دارد و کمک میکند regressionها و مشکلهای configuration را زودتر پیدا کنید. استفاده از Postman CLI GitHub Action در workflow مشخص میکنید چه...
