هر پاسخ ردی یک کد خطا دارد. فیلد `code` در پاسخ را بخوانید: مشخص می‌کند با کدام‌یک از حالت‌های زیر روبه‌رو هستید.

## `ip_not_allowed` (403)
کلید معتبر است، اما درخواست از آدرسی که کلید به آن بسته شده نیامده است.
- IP کنار کلید را در **🤝 نمایندگی** و سپس **🔑 کلیدهای API** بررسی کنید. باید آدرس عمومی‌ای باشد که نرم‌افزار شما از آن به بیرون وصل می‌شود، نه آدرس خانه یا دفترتان.
- اگر آدرس سرورتان تغییر کرده، روی همان کلید **📍 تغییر آی‌پی** را بزنید.
- اگر متن خطا می‌گوید درخواست از راه IPv6 رسیده، آدرسی که به کلوداسنپ رسیده آدرس واقعی شما نبوده و هیچ کلیدی با آن تطبیق پیدا نمی‌کند. کلاینت HTTP خود را روی IPv4 تنظیم کنید (مثلاً `curl -4`) و مطمئن شوید کلید به آدرس IPv4 شما بسته شده است. راهنمای **Authentication** در مستندات API این تنظیم را برای زبان‌های رایج نشان می‌دهد.

## `key_expired` یا `key_revoked` (401)
مدت اعتبار کلید تمام شده یا کلید باطل شده است. کلید جدیدی بسازید و نرم‌افزارتان را روی آن ببرید.

## `invalid_key` یا `unauthorized` (401)
کلید شناخته نشد یا اصلاً کلیدی ارسال نشده است. بررسی کنید که آن را کامل کپی کرده‌اید و به‌صورت `Authorization: Bearer` و سپس خود کلید ارسال می‌کنید. اگر کلید کامل را دیگر ندارید، آن را باطل کنید و کلید جدید بسازید؛ کلید دوباره نمایش داده نمی‌شود.

## `suspended` (403)
حساب نمایندگی شما در حال حاضر فعال نیست و به همین دلیل همهٔ کلیدها رد می‌شوند. در ربات پیام «حساب نمایندگی شما فعال نیست» را می‌بینید. سرورهایی که از قبل دارید روشن می‌مانند. با پشتیبانی تماس بگیرید.

## `throttled` (429)
نرم‌افزار شما سریع‌تر از سقف مجاز حسابتان درخواست می‌فرستد. پیش از تلاش دوباره، به اندازهٔ زمانی که در هدر `Retry-After` آمده صبر کنید.

## اگر مشکل حل نشد
به پشتیبانی پیام دهید و شناسهٔ تلگرام، چند نویسهٔ اول کلید همان‌طور که در فهرست کلیدها نمایش داده می‌شود (هرگز کلید کامل را نفرستید)، آدرس IP‌ای که سرورتان از آن درخواست می‌فرستد، زمان درخواست و پاسخ کامل خطا را بنویسید.