# Dollar Exchange Rate API این API **آخرین نرخ دلار** را در اختیار شما قرار می‌دهد. اطلاعات نرخ دلار به صورت دوره‌ای به‌روزرسانی شده و API در هر درخواست، آخرین داده ثبت‌شده را بازمی‌گرداند. ## نحوه استفاده برای استفاده از این API کافی است یک درخواست **GET** به Endpoint مربوطه ارسال کرده و توکن خود را در بخش **Authorization Header** قرار دهید. هر کاربر می‌تواند حداکثر **10000 درخواست در روز** برای این سرویس ارسال کند. --- ## پاسخ API پاسخ API شامل اطلاعات نرخ دلار و زمان ثبت آن است. | Field | توضیح | | ----------- | ----------------------------------------------------------------------- | | `dolar` | قیمت فعلی دلار | | `date` | تاریخ ثبت قیمت | | `hour` | ساعت ثبت قیمت | | `minute` | دقیقه ثبت قیمت | | `nonrecent` | مشخص می‌کند که آیا اطلاعات بیش از ۵ دقیقه از زمان فعلی گذشته است یا خیر | --- ## نمونه پاسخ ```json { "dolar": 95000, "date": "2026-08-13", "hour": 14, "minute": 32, "nonrecent": false } ``` ## اطلاعات غیر به‌روز اگر آخرین اطلاعات موجود بیش از **۵ دقیقه** از زمان فعلی فاصله داشته باشد، API همچنان قیمت را برمی‌گرداند، اما مقدار `nonrecent` برابر `true` خواهد بود. ```json { "dolar": 95000, "date": "2026-08-13", "hour": 14, "minute": 20, "nonrecent": true } ``` > **نکته:** مقدار `nonrecent` را بررسی کنید. اگر مقدار آن `true` باشد، قیمت موجود ممکن است به‌روز نباشد. > **نکته:** اگر اطلاعات بیش از حدود یک ساعت قدیمی باشد یا مربوط به روز جاری نباشد، API به جای قیمت، خطای `500` برمی‌گرداند و باید برای به‌روزرسانی اطلاعات با پشتیبانی تماس بگیرید. > **محدودیت استفاده:** هر کاربر مجاز به ارسال حداکثر **10000 درخواست در روز** برای این سرویس است. تولید نمونه