# کدهای وضعیت

پاسخ‌های رایج APIها و راه بررسی خطا را در جدول ببینید. هر سرویس ممکن است فقط بخشی از این کدها را برگرداند.

| کد | عنوان | توضیح |
| --- | --- | --- |
| `200` | OK | درخواست با موفقیت پردازش شده و پاسخ معتبر برگشته است. |
| `204` | No Content | درخواست موفق بوده، اما بدنهٔ پاسخ خالی است؛ برای نمونه، ممکن است تایل برداریِ درخواستی داده‌ای نداشته باشد. |
| `400` | Bad Request | پارامترهای ورودی ناقص یا نامعتبر هستند؛ برای نمونه، فرمت `location` یا محدوده `zoom` درست نیست. |
| `401` | Unauthorized | کلید API ارسال نشده است. |
| `403` | Forbidden | کلید API نامعتبر، غیرفعال یا متعلق به سازمان غیرفعال است؛ یا IP، Origin یا سرویس درخواست در محدودیت‌های کلید مجاز نیست. |
| `404` | Not Found | مسیر، نوع منبع یا تایل درخواست‌شده وجود ندارد. |
| `429` | Too Many Requests | سقف مصرف یا محدودیت نرخ درخواست برای کلید API پر شده است. |
| `5xx` | Server Error | خطای داخلی سرویس یا سرویس بالادستی رخ داده است. درخواست را با وقفه مناسب تکرار کنید. |

## رفع خطای دسترسی

اگر پاسخ `401` است، وجود کلید را در هدر یا نشانی درخواست بررسی کنید. اگر پاسخ `403` است، فعال‌بودن کلید و سازمان، دسترسی سرویس و محدودیت IP یا Origin را در داشبورد بررسی کنید.

[راهنمای کلید API و دسترسی](/dashboard/docs/authentication)