کدهای وضعیت
پاسخ‌های رایج 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 را در داشبورد بررسی کنید.