Postman می‌تواند درخواست API شما را به نمونه کد تبدیل کند. این قابلیت زمانی مفید است که ابتدا درخواست را در Postman تست کرده‌اید و بعد می‌خواهید همان درخواست را در برنامه، اسکریپت، ابزار خط فرمان یا سرویس خودتان اجرا کنید.
نمونه کد تولیدشده بر اساس URL، متد، Headerها، پارامترها، Body و تنظیمات همان درخواست ساخته می‌شود. بنابراین قبل از کپی کردن کد، بهتر است مطمئن شوید درخواست در Postman درست اجرا می‌شود.
تولید Code Snippet در Postman
- درخواست موردنظر را باز کنید.
- در نوار کناری سمت راست، روی Code کلیک کنید.
- از فهرست زبان‌ها و کتابخانه‌ها، گزینه مناسب پروژه خود را انتخاب کنید؛ مثلا JavaScript Fetch، Python Requests، cURL، NodeJS Axios یا Java OkHttp.
- روی Copy snippet بزنید تا کد در Clipboard کپی شود.
- اگر به تنظیمات بیشتری مثل نوع تورفتگی، تعداد فاصله‌ها یا قالب خروجی نیاز دارید، از Code settings استفاده کنید. این تنظیمات بسته به زبان انتخاب‌شده متفاوت است.
زبان‌ها و کتابخانه‌های پشتیبانی‌شده
Postman برای زبان‌ها و ابزارهای مختلف خروجی آماده می‌سازد. موارد رایج شامل این گزینه‌ها هستند:
| زبان | کتابخانه یا قالب |
|---|---|
| C# | HttpClient، RestSharp |
| cURL | cURL |
| Dart | Dio، HTTP |
| Go | net/http |
| HTTP | درخواست خام HTTP |
| Java | OkHttp، Unirest |
| JavaScript | Fetch، jQuery، XHR |
| Kotlin | OkHttp |
| C | LibCurl |
| NodeJS | Axios، Native، Request، Unirest |
| Objective-C | NSURLSession |
| OCaml | Cohttp |
| PHP | cURL، Guzzle، Http_Request2، pecl_http |
| Postman CLI | postman request |
| PowerShell | RestMethod |
| Python | http.client، Requests |
| R | httr، RCurl |
| Ruby | NET::Http |
| Rust | reqwest |
| Shell | Httpie، wget |
| Swift | URLSession |
نکته‌های کاربردی
- Code Snippet جایگزین تست کردن نیست؛ ابتدا پاسخ API را در Postman بررسی کنید، سپس کد را به پروژه منتقل کنید.
- اگر درخواست شما از متغیرهای Postman استفاده می‌کند، مقدار واقعی آن متغیرها را در کد نهایی خودتان مدیریت کنید.
- برای اطلاعات حساس مثل Token یا API Key، مقدار را مستقیم داخل کد قرار ندهید و از متغیر محیطی یا Secret Manager استفاده کنید.
- اگر می‌خواهید زبان یا تنظیم جدیدی اضافه شود، Postman پروژه متن‌باز code generators را برای مشارکت توسعه‌دهندگان ارائه کرده است.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.