چطور کلید API بسازم و آن را به IP سرورم ببندم؟

C

CloudSnap Agent

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

در 🤝 نمایندگی روی 🔑 کلیدهای API و سپس ➕ کلید جدید بزنید، مدت اعتبار کلید را انتخاب کنید و آدرس IP عمومی‌ای را که نرم‌افزارتان از آن درخواست می‌فرستد ارسال کنید. ربات کلید را فقط یک بار نشان می‌دهد، پس همان لحظه آن را کپی کنید.

ساخت کلید

  1. روی 🤝 نمایندگی و سپس 🔑 کلیدهای API بزنید.
  2. روی ➕ کلید جدید بزنید. اگر این دکمه را نمی‌بینید، به حداکثر تعداد کلید فعال رسیده‌اید؛ صفحه نشان می‌دهد چند کلید در حال استفاده است.
  3. یکی از مدت‌های اعتبار را از دکمه‌ها انتخاب کنید.
  4. آدرس IP‌ای را که کلید از آن استفاده می‌شود بفرستید: آدرس عمومی‌ای که سرور شما واقعاً از آن به بیرون وصل می‌شود، که معمولاً همان آدرسی نیست که با آن مرور می‌کنید. فقط یک آدرس بفرستید، مثلاً 203.0.113.7. آدرس‌های خصوصی پذیرفته نمی‌شوند.
  5. ربات با کلید API جدید شما پاسخ می‌دهد. همین حالا کپی‌اش کنید. دیگر نمایش داده نمی‌شود و هیچ‌کس، حتی پشتیبانی، نمی‌تواند آن را بازیابی کند.

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

مدیریت کلیدها

فهرست، ابتدای هر کلید، IP آن، تاریخ انقضا و آخرین زمان استفاده را نشان می‌دهد. زیر هر کلید:

  • 📍 تغییر آی‌پی: آدرس جدید را بفرستید. آدرس قبلی فوراً از کار می‌افتد.
  • 🗑 ابطال: کلید همان لحظه از کار می‌افتد.

برای جایگزینی کلید، اول کلید جدید را بسازید، نرم‌افزارتان را روی آن ببرید و بعد کلید قبلی را باطل کنید. کلید گم‌شده قابل بازیابی نیست: آن را باطل کنید و کلید تازه بسازید. اگر آدرس کال‌بک تنظیم کرده باشید، رویداد api_key.expiring پیش از انقضای کلید به شما هشدار می‌دهد.

صفحهٔ API & webhooks در پنل هم همین کارها را انجام می‌دهد، پس از اینکه با رمز عبور (و اگر Authenticator دارید، کد آن) تایید کنید که خودتان هستید. با یک کلید هرگز نمی‌توان کلیدی ساخت یا تغییر داد.

از کدام آدرس استفاده کنم

ربات هم IPv4 و هم IPv6 را می‌پذیرد، اما مستندات API از نرم‌افزارها می‌خواهد با IPv4 وصل شوند: درخواستی که از راه IPv6 برسد آدرس واقعی شما را همراه ندارد و با هیچ کلیدی تطبیق پیدا نمی‌کند. کلید را به آدرس IPv4 عمومی سرورتان ببندید و کلاینت HTTP خود را روی IPv4 تنظیم کنید. راهنمای Authentication در مستندات روش کار را نشان می‌دهد.

اگر مشکل حل نشد

اگر ساخت کلید ناموفق بود، فهرست کلیدها را باز کنید و دوباره تلاش کنید. اگر باز هم ناموفق بود، به پشتیبانی پیام دهید و شناسهٔ تلگرام، زمان و پیامی که دیدید را بنویسید. هرگز کلید کامل را نفرستید؛ چند نویسهٔ اولی که در فهرست نمایش داده می‌شود کافی است.