دسترسی به Postman API برای هر کاربر در بازه‌های زمانی مشخص محدود می‌شود. وقتی با API key درخواست می‌فرستید، سقف پایه ۳۰۰ درخواست در دقیقه است. پاسخ‌های API شامل headerهایی هستند که وضعیت مصرف و زمان reset شدن محدودیت را نشان می‌دهند.
headerهای مهم محدودیت نرخ
| Header | معنی |
|---|---|
RateLimit: limit=300, remaining=###, reset=## |
سقف فعلی، تعداد درخواست باقی‌مانده و زمان reset شدن پنجره فعلی بر حسب ثانیه. |
RateLimit-Policy: 300;w=60 |
سیاست محدودیت نرخ و پنجره reset؛ در این مثال ۳۰۰ درخواست در ۶۰ ثانیه. |
X-RateLimit-Limit یا RateLimit-Limit |
حداکثر تعداد درخواست مجاز در هر دقیقه. |
X-RateLimit-Remaining یا RateLimit-Remaining |
تعداد درخواست باقی‌مانده در پنجره فعلی. |
X-RateLimit-Reset یا RateLimit-Reset |
زمان reset شدن پنجره فعلی، به‌صورت UTC epoch seconds. |
X-RateLimit-RetryAfter یا RetryAfter |
اگر از سقف عبور کرده باشید، چند ثانیه باید صبر کنید تا دوباره درخواست بفرستید. |
RateLimit-Limit-Month یا X-RateLimit-Limit-Month |
کل درخواست‌های مجاز در ماه، بر اساس پلن Postman. |
RateLimit-Remaining-Month یا X-RateLimit-Remaining-Month |
تعداد درخواست باقی‌مانده در ماه جاری. |
چطور از این headerها استفاده کنیم؟
- در ابزارهای خود مقدار
remainingرا بررسی کنید تا قبل از رسیدن به سقف، سرعت درخواست‌ها را کم کنید. - اگر پاسخ شامل
RetryAfterبود، همان مقدار را مبنای retry بعدی قرار دهید. - برای اجرای‌های CI/CD، مصرف ماهانه را هم کنترل کنید تا jobهای مهم در پایان ماه با محدودیت مواجه نشوند.
- برای عملیات حجیم، درخواست‌ها را batch کنید یا فقط داده‌هایی را بخوانید که واقعا نیاز دارید.
مصرف ماهانه
حساب Postman شما تعداد مشخصی فراخوانی رایگان در ماه دارد و مقدار دقیق آن به پلن بستگی دارد. می‌توانید مصرف را از طریق Postman API یا صفحه resource usage بررسی کنید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.