دسته‌ها را مشاهده کنید

مرجع جریان‌ها

49 مستندات

مرجع Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

بخش مرجع Postman Flows توضیح‌ها، جزئیات و مثال‌هایی برای blockها، تابع‌های TypeScript و Flows Query Language یا FQL ارائه می‌کند.

مرجع blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

در Postman Flows هر block یک واحد اصلی برای نگهداری داده یا انجام یک کار است و با portها به blockهای دیگر وصل می‌شود.

مروری بر Action blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Action blockها در Postman Flows برای انجام کارهایی مثل اتصال به سرویس‌های خارجی، ارسال request و اجرای Flow دیگر استفاده می‌شوند.

Connector blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Connector blockها به Flow اجازه می‌دهند با سرویس‌های خارجی پشتیبانی‌شده مثل Calendly و Figma کار کند.

HTTP Request block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

HTTP Request block یک request از collection را اجرا می‌کند و response و نتیجه testها را از خروجی‌های Success یا Fail به Flow می‌فرستد.

Flow block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Flow block به شما اجازه می‌دهد یک Flow دیگر را از داخل Flow فعلی اجرا کنید و خروجی آن را در منطق خودتان استفاده کنید.

مروری بر Trigger blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Trigger blockها در Postman Flows شروع اجرای Flow یا دریافت و ارسال داده در Flowهای deploy شده را کنترل می‌کنند.

Output block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Output block داده یک Flow را به Flow block در Flow دیگر می‌فرستد و برای ساخت Flowهای قابل استفاده مجدد کاربرد دارد.

Request block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Request block داده request ارسال‌شده به URL یک deployed flow را دریافت می‌کند و headers، params و body را به Flow می‌دهد.

Response block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Response block پاسخ HTTP را از یک deployed flow به درخواست ارسال‌شده به URL همان Flow برمی‌گرداند.

Schedule block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Schedule block زمان و تکرار اجرای خودکار یک Flow را در Postman cloud مشخص می‌کند.

Start block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Start block به صورت خودکار به هر Flow جدید اضافه می‌شود و اجرای blockهای متصل یا داده‌های scenario را شروع می‌کند.

MCP block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

MCP block به شما اجازه می‌دهد یک Flow را به عنوان MCP server deploy کنید و ابزارهای آن را با schema تعریف کنید.

مروری بر AI blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

در Postman Flows، AI blockها برای اضافه کردن قابلیت‌های هوش مصنوعی به جریان‌ها استفاده می‌شوند. این blockها می‌توانند متن، تصویر، داده ساختاریافته، یا پاسخ‌های تولیدشده توسط مدل‌های هوش مصنوعی را وارد اجرای Flow کنند. AI blockهای موجود در بخش مرجع Postman Flows، AI blockها شامل موارد زیر هستند: AI Agent: برای اجرای وظایف پیچیده‌تر، تحلیل...

AI Agent block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

AI Agent block برای خودکارسازی وظایف در Postman Flows استفاده می‌شود. این block می‌تواند داده‌ها را تحلیل کند، محتوا بسازد، تصمیم بگیرد، و در صورت نیاز از ابزارها، Flowهای دیگر، یا MCP Serverها کمک بگیرد. دو نوع AI Agent Postman برای AI Agent دو مسیر ارائه می‌کند: AI Agent Legacy: نسخه قدیمی‌تر که می‌تواند بر...

AI Media block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

AI Media block از مدل‌های هوش مصنوعی برای تولید تصویر بر اساس prompt متنی استفاده می‌کند. برای مثال می‌توانید promptی مثل ساخت تصویر پروفایل عمومی یا تصویر یک فضانورد در حال مطالعه وارد کنید. این block می‌تواند خروجی blockهای دیگر را به متغیر داخلی خود وصل کند یا با استفاده از data blockها داده دریافت...

Create with AI block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Create with AI block در آینده منسوخ می‌شود و قرار است با AI Media block جایگزین شود. با این حال، این block همچنان در Flowهای موجود ممکن است برای تولید متن، تصویر، یا JSON بر اساس promptهای متنی دیده شود. برای مثال می‌توانید promptی برای ساخت تصویر پروفایل، نوشتن ایمیل خوشامدگویی، یا تولید داده JSON...

AI Request block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

AI Request block یک AI request از collection شما را اجرا می‌کند و نتیجه را از یکی از پورت‌های خروجی ارسال می‌کند. این block از نظر کاربرد شبیه HTTP Request است، اما به جای ارسال درخواست HTTP به یک API، یک prompt را به AI model می‌فرستد. اگر prompt داخل AI request شامل variableهایی داخل...

مروری بر Logic blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Logic blocks در Postman Flows برای کنترل مسیر حرکت داده و تصمیم‌گیری در جریان استفاده می‌شوند. این blockها کمک می‌کنند Flow فقط یک مسیر ثابت نداشته باشد و بتواند بر اساس شرط، نتیجه، زمان‌بندی یا مقدار داده، مسیر متفاوتی را دنبال کند. Logic blockهای موجود Condition: برای بررسی چند شرط و ارسال داده از اولین...

Condition block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Condition block یک دروازه منطقی است که داده را بر اساس نتیجه یک یا چند شرط، از یکی از چند پورت خروجی عبور می‌دهد. این block داده ورودی را به variableها اختصاص می‌دهد و سپس آن variableها را با expressionهای true/false که شما می‌نویسید بررسی می‌کند. expressionها می‌توانند با TypeScript یا Flows Query Language (FQL)...

If block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

If block یک دروازه منطقی است که داده را بر اساس نتیجه یک evaluation از یکی از دو خروجی عبور می‌دهد. این block می‌تواند داده را با expressionهای TypeScript یا Flows Query Language (FQL) بررسی کند. If برای زمانی مناسب است که Flow دقیقاً باید بین دو مسیر منطقی شاخه‌بندی شود. اگر چند شرط یا...

Validate block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Validate block یک دروازه منطقی است که داده JSON ورودی را با یک schema بررسی می‌کند و سپس داده را بر اساس نتیجه از مسیر مناسب عبور می‌دهد. اگر JSON با schema سازگار باشد، داده از خروجی Pass ارسال می‌شود. اگر سازگار نباشد، داده از خروجی Fail عبور می‌کند. می‌توانید schema را خودتان داخل Validate...

Evaluate block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Evaluate block ابزاری قدرتمند برای پردازش، تغییر، بررسی و اعتبارسنجی داده در Postman Flows است. از این block می‌توانید برای فیلتر کردن داده، اجرای منطق شرطی، ساخت منطق پیچیده‌تر، و گرفتن نتیجه قابل استفاده در مراحل بعدی Flow استفاده کنید. Evaluate با TypeScript scriptها یا Flows Query Language (FQL) queryها کار می‌کند. هنگام استفاده از...

Delay block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Delay block داده را از یک یا چند block دریافت می‌کند، سپس به اندازه تعداد میلی‌ثانیه‌ای که تعیین کرده‌اید صبر می‌کند و بعد همان داده را از خروجی ارسال می‌کند. تایمر Delay از لحظه‌ای شروع می‌شود که block داده را دریافت کند. اگر Delay block از چند block مختلف داده دریافت کند، برای هر داده...

OR block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

OR block دو ورودی دارد و داده‌ای را ارسال می‌کند که زودتر از یکی از این دو ورودی برسد. این block زمانی مفید است که دو مسیر مختلف در Flow به یک block مشترک می‌رسند، اما در هر اجرای Flow فقط یکی از مسیرها داده دارد. اگر دو مسیر را مستقیم به block نهایی وصل...

مروری بر Looping blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Looping blockها در Postman Flows برای ساخت حلقه و اجرای تکراری بخشی از یک Flow استفاده می‌شوند. این گروه از blockها زمانی کاربرد دارد که بخواهید یک مجموعه عملیات را چند بار اجرا کنید، روی آیتم‌های یک لیست حرکت کنید، یا خروجی چند اجرای جداگانه را دوباره در یک آرایه جمع کنید. در مرجع Postman...

Repeat block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Repeat block نقطه شروع یک حلقه در Postman Flows است. حلقه از این block آغاز می‌شود، از blockهای بعدی عبور می‌کند و معمولاً با یک Collect block پایان می‌یابد. از این نوع حلقه زمانی استفاده می‌کنید که بخواهید یک سری عملیات را چند بار اجرا کنید. Inputs Count – تعداد دفعات اجرای Repeat block را...

For block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

For block همیشه نقطه شروع یک حلقه است. این block یک control block در Postman Flows محسوب می‌شود و برای اجرای چندباره یک زنجیره از blockها در Flow به کار می‌رود. ورودی آن یک آرایه است و هر آیتم آرایه را جداگانه و به ترتیب از پورت خروجی خود ارسال می‌کند. در پایان حلقه، بعد...

Collect block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Collect block آیتم‌های داده‌ای جداگانه را از تکرارهای یک حلقه دریافت می‌کند و آن‌ها را در یک لیست جمع می‌کند. خروجی این block به شکل یک JSON array ساخته می‌شود؛ برای مثال ["item1","item2","item3"]. برای نمونه، اگر یک حلقه در هر تکرار یک HTTP request ارسال کند، Collect block می‌تواند بعد از پایان حلقه همه پاسخ‌ها...

مروری بر Visualize blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Visualize blockها در Postman Flows برای نمایش، بررسی و ثبت خروجی داده‌ها استفاده می‌شوند. این blockها کمک می‌کنند داده‌ای را که از blockهای دیگر می‌آید ببینید، در داشبورد نمایش دهید، یا برای عیب‌یابی در Postman Console ثبت کنید. در مرجع Postman Flows، Visualize blockها شامل دو block اصلی هستند: Display برای نمایش داده در قالب‌هایی...

Display block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Display block داده‌ای را که از blockهای دیگر می‌آید نمایش می‌دهد. این نمایش می‌تواند در قالب‌های مختلفی مثل تصویر، متن، عدد، جدول یا نمودار باشد. Display معمولاً بهترین قالب را بر اساس داده ورودی تشخیص می‌دهد، اما می‌توانید قالب نمایش را از فهرست کشویی هم انتخاب کنید. Display block یک پورت خروجی هم دارد؛ بنابراین...

Log block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Log block داده‌ای را از پورت ورودی خود دریافت می‌کند و آن را به Postman Console می‌فرستد. این block برای عیب‌یابی Flowها مفید است، چون می‌توانید ببینید در زمان اجرا چه داده‌هایی از مسیرهای مختلف عبور می‌کنند. Input Log block یک پورت ورودی دارد که داده را از خروجی هر block دیگری می‌پذیرد. اگر چند...

مروری بر Data blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Data blockها در Postman Flows برای ساخت، نگهداری، انتخاب، قالب‌بندی و خواندن داده‌ها استفاده می‌شوند. این blockها پایه بسیاری از Flowها هستند، چون داده‌ای را آماده می‌کنند که blockهای دیگر با آن کار می‌کنند. در مرجع Postman Flows، Data blockها شامل این blockها هستند: String برای ساخت مقدار متنی. Bool برای مقدار بولی مثل true...

String block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

String block یک رشته از کاراکترها را که داخل خود block تنظیم کرده‌اید از خروجی ارسال می‌کند. از این block زمانی استفاده می‌کنید که لازم است یک متن ثابت را به ورودی block دیگری بفرستید. برای نمونه، اگر بخواهید یک پارامتر ثابت را برای یک API request مشخص کنید، یا مقدار یک variable را با...

Bool block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Bool block از پورت خروجی خود یک مقدار true یا false ارسال می‌کند. این block زمانی مفید است که بخواهید مسیر اجرای Flow را بر اساس یک شرط کنترل کنید. برای مثال، می‌توانید خروجی Bool block را به یک If block بفرستید. سپس If block می‌تواند داده ورودی را بر اساس true یا false بودن...

Number block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Number block عدد مشخص‌شده داخل block را ارسال می‌کند. این عدد می‌تواند صحیح یا اعشاری، مثبت یا منفی باشد. Number block معمولاً داخل blockهای دیگری درج می‌شود که عملیات ریاضی انجام می‌دهند، یا لازم است مقدار یک پارامتر عددی را تعیین کنند. برای مثال، می‌توانید از آن برای تعیین تعداد اجرای یک حلقه یا مقداردهی...

Null block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

وقتی یک Flow اجرا می‌شود، Null block از پورت خروجی خود مقدار null ارسال می‌کند. مقدار null یعنی مقدار خالی یا نبود مقدار. مقدار null در موقعیت‌های مختلفی کاربرد دارد؛ برای مثال وقتی پاسخ API شامل فیلدهایی با مقدار null است، یا وقتی می‌خواهید مقدار یک data block درج‌شده را پاک یا خالی کنید. Output...

Select block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Select block داده JSON را از block دیگری می‌گیرد و فقط بخشی را که شما مشخص می‌کنید بیرون می‌کشد. این block وقتی کاربردی است که خروجی یک HTTP Request شامل داده‌های زیادی است و شما فقط به یک فیلد یا یک بخش مشخص از پاسخ نیاز دارید. Input پورت ورودی این block را به blockی...

Now block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

وقتی یک Flow اجرا می‌شود، Now block تاریخ و زمان همان لحظه را ارسال می‌کند. مقدار خروجی به‌صورت تعداد میلی‌ثانیه‌های گذشته از Unix epoch است؛ یعنی از January 1, 1970 تا زمان اجرای Flow. از این block زمانی استفاده کنید که به timestamp نیاز دارید؛ برای مثال وقتی می‌خواهید زمان اجرای Flow را ثبت کنید،...

Date block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Date block یک تاریخ مشخص را ارسال می‌کند. مقدار خروجی به‌صورت تعداد میلی‌ثانیه‌های گذشته از Unix epoch است؛ یعنی از January 1, 1970 تا تاریخی که انتخاب کرده‌اید. این block برای زمانی مناسب است که فقط به تاریخ نیاز دارید و زمان روز برای شما مهم نیست. Output Date block یک پورت خروجی دارد. این...

List block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

List block در Flow یک آرایه ارسال می‌کند. آرایه یعنی مجموعه‌ای از چند مقدار که هر مقدار جایگاه مشخصی دارد. می‌توانید داخل List block، data blockهای مختلفی مثل Now، Bool، String، Number یا blockهای دیگر را درج کنید. هر آیتم داخل لیست یک شماره index دارد که جایگاه آن آیتم را نشان می‌دهد. شماره‌گذاری از...

Record block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Record block داده‌ها را به شکل جفت‌های key-value می‌سازد و آن‌ها را به‌صورت یک JSON object ارسال می‌کند. این block برای مرتب‌سازی، ساختاردهی و تبدیل داده در Flow کاربرد دارد. برای مثال، می‌توانید از Record block برای ساخت payload یک API request استفاده کنید، یا چند داده مختلف را از چند پاسخ جداگانه بگیرید و...

Create Variable block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Create Variable block یک variable می‌سازد، برای آن نام تعیین می‌کند و یک مقدار به آن اختصاص می‌دهد. بعد از ساخت variable، می‌توانید با یک یا چند Get Variable block در هر جای همان Flow به مقدار آن دسترسی داشته باشید. مقدار variable از blockی می‌آید که به پورت ورودی Create Variable وصل شده است....

Get Variable block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Get Variable block مقدار variableای را می‌خواند که با یک Create Variable block در همان Flow ساخته شده است. سپس مقدار خوانده‌شده را از پورت خروجی خود ارسال می‌کند. از این block زمانی استفاده کنید که یک مقدار را در بخشی از Flow ساخته‌اید و لازم است همان مقدار را در بخش دیگری دوباره استفاده...

Template block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Template block به شما اجازه می‌دهد مقدار variableها را داخل یک متن یا JSON از پیش آماده وارد کنید و خروجی نهایی را به block دیگری بفرستید. برای مثال می‌توانید متن یک ایمیل آماده داشته باشید و نام مشتری یا نام محصول را در زمان اجرای Flow داخل آن جایگزین کنید. همچنین می‌توانید data blockهایی...

Get Configuration block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Get Configuration block مقدار یک configuration مشخص را می‌خواند و آن مقدار را از پورت خروجی خود ارسال می‌کند. از این block زمانی استفاده کنید که در تنظیمات Flow مقدارهایی مثل آدرس، کلید، گزینه اجرایی یا مقدار قابل تغییر دیگری تعریف کرده‌اید و می‌خواهید همان مقدار را داخل Flow استفاده کنید. Output Select a configuration:...

نمای کلی Deployed flows در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

در Postman می‌توانید Flow را در Postman Cloud مستقر و اجرا کنید. Flowهای مستقرشده در Cloud می‌توانند با زمان‌بندی خودکار، webhook، درخواست‌های برنامه‌های دیگر یا APIهای خارجی اجرا شوند. این مدل برای اتوماسیون، ساخت API کوچک، پاسخ‌دادن به webhookها، و حتی ارائه یک ابزار AI برای MCP serverها کاربرد دارد. وقتی یک Flow با محرک...

نمای کلی Connector blockها در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

در Postman Flows می‌توانید با بلوک‌های Connector سرویس‌های بیرونی را به Flow وصل کنید. هر Connector block از OAuth ۲.۰ برای اتصال امن به یک سرویس استفاده می‌کند و بعد از اتصال، Flow می‌تواند عملیات همان سرویس را اجرا کند. برای نمونه، یک Flow می‌تواند در Calendly رویدادها را جست‌وجو یا لغو کند، در Salesforce...

Date and Time block در Postman Flows

آخرین به‌روزرسانی: ۱۴۰۵-۰۴-۱۵

Date & Time block یک data block است که تاریخ و زمان مشخص‌شده را ارسال می‌کند. مقدار خروجی به‌صورت تعداد میلی‌ثانیه‌های گذشته از Unix epoch است؛ یعنی از January 1, 1970 تا تاریخ و زمان انتخاب‌شده. این block زمانی مناسب است که هم تاریخ و هم ساعت برای محاسبه یا ارسال داده مهم هستند. Output...