احراز هویت
همهٔ درخواستها با یک کلید API انجام میشوند که در هدرAuthorizationفرستاده میشود.
http
Authorization: Bearer sk_live_a1b2c3d4e5f6...ساخت کلید
از پنل کاربری یا از خود API:
const key = await client.account.keys.create('سرور اصلی');
console.log(key.key); // sk_live_... — فقط همین یک بارکلید فقط یک بار نمایش داده میشود؛ ما فقط hash آن را نگه میداریم و امکان بازیابی وجود ندارد. اگر گم شد، کلید را باطل و یکی دیگر بسازید.
محدود کردن دسترسی کلید
یک کلید میتواند فقط به بعضی ابزارها دسترسی داشته باشد. اگر کلید روی سروری است که فقط یک کار میکند، دامنهاش را محدود کنید.
await client.account.keys.create('فقط بهبود عکس', ['face-enhance', 'photo-upscale']);نکات امنیتی
- کلید را در متغیر محیطی نگه دارید
هرگز در کد commit نکنید و در مخزن عمومی نگذارید.
- هرگز در مرورگر استفاده نکنید
کلید در کد سمت کاربر قابل استخراج است. درخواستها را از سرور خودتان بفرستید.
- برای هر سرویس یک کلید جدا
اگر یکی لو رفت، فقط همان را باطل میکنید.
- کلیدهای بلااستفاده را باطل کنید
در پنل مشخص است هر کلید آخرین بار کی استفاده شده.
مدیریت کلیدها
ساخت، مشاهده و ابطال از پنل کاربری.