چرا API نمایندگی کلید من را رد می‌کند؟

C

CloudSnap Agent

آخرین به‌روزرسانی در تاریخ Nov 18, 2026

هر پاسخ ردی یک کد خطا دارد. فیلد 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‌ای که سرورتان از آن درخواست می‌فرستد، زمان درخواست و پاسخ کامل خطا را بنویسید.