[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"post:postman-introduction":3},{"id":4,"documentId":5,"title":6,"desc":7,"content":8,"image":9,"imageCard":10,"imageBackground":11,"slug":12,"publishedAt":13,"baseUrl":14,"tags":15,"writer":31,"editors":40,"organization":11,"vars":41},720,"hqs6mgftb5e71y6xhhpzzv2u","شروع کار با Postman در تست API","هر API مانند واسطی عمل می‌کند که سیستم‌های مختلف با یکدیگر ارتباط برقرار می‌کند. Postman یکی از ابزارهای قدرتمند و محبوب برای تست API می‌باشد و دارای رابط گرافیکی آسانی است. شما می‌توانید از این ابزار برای تست درخواست‌های ‌HTTP استفاده نمایید.","## چرا تست API اهمیت دارد؟\nدر حال حاضر بسیاری از شرکت‌ها به سمت توسعه و پیاده‌سازی سیستم‌های مبتنی بر معماری microservice پیش می‌روند. microserviceها برای تولیدکنندگان نرم‌افزار جذاب هستند زیرا اجازه می‌دهند اجزای نرم‌افزار با سرعت بیشتری توسعه داده شوند. زمانی که یک بخش از برنامه در حال  بروزرسانی می‌باشد، بخش‌های دیگر برنامه می‌توانند به کار خود ادامه دهند. در این دوره، کاربران انتظار دارند نرم افزار هر زمان که بخواهند برای استفاده در دسترس باشد. بنابراین با توجه به این موضوع که سیستم‌های نرم‌افزاری باید همیشه در دسترس باشند، تست نرم‌افزار از اهمیت بالایی برخوردار می‌شود.\nاکثر microserviceها از API استفاده میکنند، بنابراین تست API یک فرایند بسیار مهم برای اکثر برنامه‌های تحت وب و تلفن همراه است. حتی زمانی که رابط کاربری در دسترس است ، تست API اغلب سریع‌تر اجرا می‌شود و انعطاف پذیری بیشتری در محیط‌های microservice ایجاد می کند.\n\n\n## API چیست؟\nهر API یا (Application Programming Interface) راهی برای تعامل برنامه‌ها با یکدیگر می‌باشد. در واقع یک API رابطی است که برنامه‌ها می‌توانند با یکدیگر ارتباط برقرار کنند.\nAPI های زیادی توسط برخی شرکت‌ها در دسترس می‌باشند که به شما این امکان را می‌دهند تا با خدمات آن‌ها ارتباط برقرار کنید. رایج‌ترین نوع ‌API که هنگام تست برنامه‌ها مشاهده می‌کنید REST API است. برای تست REST API، نیاز است که endpoint ای که می خواهیم از آن استفاده کنیم را مشخص کنیم. به عبارت دیگر هر endpoint یک URL می‌باشد که دسترسی به سرویس‌های یک سیستم را امکان‌پذیر می‌کند.\nهمچنین نیاز است که فعل (Method) درخواست را نیز مشخص نماییم. هر درخواست میتواند یکی از متدهای `GET،PUT،POST،DELETE و …` را داشته باشد. این متدها مشخص میکنند که آیا ما میخواهیم اطلاعاتی را از سرور دریافت کنیم (GET)،  تغییراتی را در آن ایجاد کنیم (PUT\u002FPATCH) و … .\n\n![API Model](.\u002Fresources\u002Fapi-model.png?raw=true \"API Model\")\n \n\nتست API یکی از موارد مهم در تولید نرم‌افزار می‌باشد که باید مورد توجه قرار گیرد. برای تست API ابزار مختلفی وجود دارد که Postman یکی از ابزارهای محبوب و رایج می‌باشد.\n\n  \n## Postman چیست؟\n  Postman یک ابزار قدرتمند تست API است که امکان تست API ها را بصورت خودکار فراهم می کند. در ابتدا Postman یک افزونه Chrome بود، اما قدرتمندتر شده و به یک برنامه دسکتاپ کامل تبدیل شده است. برای شروع تست API با استفاده از این ابزار، ابتدا باید آن را نصب کنید.\n    \n### مزایای استفاده از Postman:\n  > * **استفاده رایگان**\n  > * **نصب و پیکربندی آسان**\n  > * **رابط کاربری گرافیکی:** رابط کاربری آسانی دارد و یادگیری آن نیاز به زمان زیادی ندارد.\n  > * **دسترسی آسان:** میتوان هر زمان که لازم بود تنها با وارد شدن به حساب کاربری به فایل های خود دسترسی داشت.\n    \n## نصب و راه اندازی\n### 1. دانلود و نصب Postman\nبرای دانلود این ابزار به سایت [Postman](https:\u002F\u002Fwww.postman.com\u002Fdownloads\u002F) مراجعه کرده و با  توجه به سیستم عامل خود نسخه مربوطه را دانلود کنید. پس از دانلود، آن را می توان به راحتی مانند برنامه‌های دیگر نصب کرد\n    \n### 2. راه اندازی Postman\nبرای راه‌اندازی Postman کافی است برنامه Postman را که به تازگی نصب کرده‌اید اجرا کنید. اولین باری که آن را باز می‌کنید، می‌توانید یک حساب کاربری رایگان ایجاد کنید (این مرحله اجباری نیست.) حساب رایگان برای استفاده برخی از قابلیت‌های آنلاین Postman مانند به اشتراک‌گذاری تست‌هایی که به صورت محلی اجرا می کنید مفید است.\nPostman برای تست، building blockهای مختلفی را فراهم نموده است که می‌توان برای ایجاد انواع مختلف تست API استفاده نمود. با کلیک بر روی باتن New در سمت چپ بالای صفحه می‌توانید building blockهای در دسترس را مشاهده نمایید.\n  \n![Building Blocks](.\u002Fresources\u002Fbuilding-blocks.png?raw=true \"Building Blocks\")\n\nدر این پست اجرای یک API ساده مانند درخواست دریافت آگهی‌های مربوط به خودرو سواری در سایت دیوار را بررسی میکنیم.\n    \n### 3. ایجاد یک درخواست (Request)\nپیش از ایجاد یک Request نیاز است که یک collection ساخته شود. هر collection مانند پوشه ای است که درخواست‌های مختلف را دسته بندی میکند.\nبه دو طریق می توانید یک Collection جدید ایجاد کنید:\n    \n- با کلیک بر روی Collection در بخش building block \n- استفاده از باتن پلاس در سمت چپ صفحه\n    \n![Create New Collection](.\u002Fresources\u002Fnew-collection.png?raw=true \"Create New Collection\")\n    \nسپس در قسمت Name نام مورد نظر خود را نوشته و آن را ایجاد کنید.\n    \n![Create New Collection](.\u002Fresources\u002Fcreate-collection.png?raw=true \"Create New Collection\")\n    \nپس از ایجاد یک collection زمان آن رسیده که یک Request بسازید. شما میتوانید از بخش building block و یا با کلیک راست بر روی collection ساخته شده و انتخاب گزینه Add Request درخواست خود را ایجاد کنید. \nپس از وارد کردن اسم مورد نظر، درخواست خود را ذخیره میکنیم.\n![Create New Request](.\u002Fresources\u002Fnew-request.png?raw=true \"Create New Request\")\n    \n### 4. اجرای یک درخواست\nدر این پست سعی داریم API مربوط به دریافت آگهی‌های خودرو در سایت دیوار را بررسی کنیم.    \nبا ارسال درخواست به آدرس `https:\u002F\u002Fapi.divar.ir\u002Fv8\u002Fweb-search\u002Ftehran-province\u002Fauto` درخواستی از نوع `GET` در بستر پروتکل `HTTP` به سرور دیوار ارسال میشود. پس از آن، سرور پاسخ را به مرورگر ارسال میکند و مرورگر لیست خودروها را به کاربر نمایش میدهد. لیست درخواست‌های ارسالی توسط مرورگر در قسمت `Developer tools` در تب `Network` در دسترس است. با انتخاب API مورد نظر میتوان جزییات درخواست را در تب Headers و Response مشاهده کرد.\nپس از مشاهده جزئیات API زمان آن رسیده که آن را در Postman پیاده سازی کنیم.\n![Divar](.\u002Fresources\u002Fdivar.png?raw=true \"Divar\")\n    \nبا کلیک بر روی drop down، لیستی از http methodها را مشاهده میکنید که میتوانید بسته به نیاز خود آن را تغییر دهید. این مقدار در Postman به صورت پیش فرض روی Get میباشد.\n    \n![API Methods](.\u002Fresources\u002Frequest-methods.png?raw=true \"API Methods\")\n    \nبنابراین طبق شکل زیر، متد درخواست را Get انتخاب کرده و در بخش URL آدرس ذکر شده را قرار میدهیم. سپس برای ارسال درخواست روی باتن Send کلیک میکنیم.\n    \n![Create New Request](.\u002Fresources\u002Fcreate-request.png?raw=true \"Create New Request\")\n    \nPostman بعضی از تنظیمات مورد نیاز را به صورت خودکار انجام میدهد. به عنوان مثال، هر Header و یا اطلاعات دیگری را که ممکن است به آن نیاز داشته باشید را اضافه کرده، درخواست را ارسال می کند و پس از مدت کوتاهی پاسخ را میتوانید در قسمت Body در پایین صفحه مشاهده کنید.\n  \n![Postman Response](.\u002Fresources\u002Fresponse.png?raw=true \"Postman Response\")\n  \nپس از اجرا، پاسخ درخواست را که شامل اطلاعات و لیست آگهی‌های خودرو سواری است در قالب Json دریافت میکنیم.\nشما میتوانید هر API دیگری را مانند مثال بالا و با تغییر endpoint و متد درخواست، پیاده سازی کنید. \n\nتست API در Postman شامل موارد بیشتری از ارسال یک یا دو درخواست است. ما در مقاله های بعدی به صورت کامل تر این موارد را بررسی خواهیم کرد.\n","https:\u002F\u002Fraw.githubusercontent.com\u002Fgazmeh-site\u002Fposts\u002Frefs\u002Fheads\u002Fmain\u002Ffa\u002Fpostman\u002Fintroduction\u002Fresources\u002FimageCover.png?raw=true","https:\u002F\u002Fraw.githubusercontent.com\u002Fgazmeh-site\u002Fposts\u002Frefs\u002Fheads\u002Fmain\u002Ffa\u002Fpostman\u002Fintroduction\u002Fresources\u002FimageThumbnail.png?raw=true",null,"postman-introduction","2025-12-11T14:54:16.765Z","https:\u002F\u002Fraw.githubusercontent.com\u002Fgazmeh-site\u002Fposts\u002Fmain\u002Ffa\u002Fpostman\u002Fintroduction\u002F",[16,21,26],{"id":17,"documentId":18,"name":19,"localeName":20},12,"stv6sloupdtgu31qhqusejoq","postman","پست‌من",{"id":22,"documentId":23,"name":24,"localeName":25},4,"szefdrf8dqsu6ul557hbcizz","automation","خودکارسازی",{"id":27,"documentId":28,"name":29,"localeName":30},15,"fq1gxa8hha4wvl6ubvuru8tb","api test","تست API",{"id":32,"documentId":33,"username":34,"displayName":35,"avatar":36},3,"wuxrnwziwttlhjwserl0eqq4","bahar","بهار",{"id":37,"documentId":38,"url":39},8,"k096cfedj2hppwgfrcbmchai","\u002Fuploads\u002Farabi_resize_1d530af3a2.jpg",[],{"SITE_URL":42,"PAGES_URL":43,"POSTS_URL":44},"https:\u002F\u002Fgazmeh.ir\u002Ffa","https:\u002F\u002Fgazmeh.ir\u002Ffa\u002Fpages","https:\u002F\u002Fgazmeh.ir\u002Ffa\u002Fposts"]