کلید مدیریتی، Webhook و کلید اختصاصی

وقتی کار بزرگ شد، کارهای پنل را با کد هم می‌شود انجام داد.

۵ دقیقهدرس ۸ از ۹۰ از ۳ قدم

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

کلید مدیریتی

کلید مدیریتی با کلید API فرق دارد: به مدل‌ها دسترسی ندارد، ولی می‌تواند کلید بسازد، مصرف بخواند و موجودی را ببیند. در «پروفایل و امنیت»، بخش «کلیدهای مدیریتی»، دو سطح دسترسی دارید:

سطحچه می‌تواند بکند
فقط خواندنگزارش مصرف، فهرست کلیدها و Workspaceها، موجودی
مدیریت کلیدهابه‌علاوهٔ ساختن، تغییر، چرخاندن و غیرفعال کردن کلیدها
کلید مدیریتی هم مثل رمز است و فقط یک بار نشان داده می‌شود. همیشه با کمترین دسترسی لازم بسازیدش.

Webhook

به‌جای اینکه هر چند دقیقه بپرسید خبری شده یا نه، بگذارید ما خبرتان کنیم. Webhook برای هر Workspace جدا تعریف می‌شود و از منوی همان Workspace در صفحهٔ «کلیدهای API» پیدایش می‌کنید. نشانی باید https باشد و درخواست‌ها با HMAC-SHA256 امضا می‌شوند.

  • پرداخت تأیید شد
  • کلید معلق شد
  • پلن رو به انقضا
  • موجودی یا بودجه کم
  • مدل از رده خارج شد یا قیمتش کم شد
  • هر درخواست، فقط با متادیتا (مدل، توکن، هزینه و تأخیر)

اگر ۲۵ بار پشت سر هم تحویل ناموفق باشد، Webhook خاموش می‌شود و بعد از رفع مشکل باید دوباره روشنش کنید. اگر می‌خواهید درخواست‌ها را در ابزار مانیتورینگ خودتان ببینید، خروجی OTLP/HTTP هم هست.

کلید اختصاصی (BYOK)

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

این قابلیت برای هر حساب جداگانه فعال می‌شود. اگر صفحهٔ «کلید اختصاصی» برایتان قفل است، یک تیکت بزنید.

اگر کلید شما نامعتبر باشد یا اعتبارش تمام شده باشد، درخواست خطا می‌گیرد و ما به‌جایش از کیف پول شما خرج نمی‌کنیم، چون چنین تصمیمی را شما نگرفته‌اید.

یک کلید مدیریتی فقط‌خواندنی۰ از ۳ قدم

  1. یک کلید با سطح «فقط خواندن» بسازید و نامش را بگذارید «گزارش‌گیری».
  2. کلید را جای امنی نگه دارید.
کلیدهای مدیریتی

خلاصهٔ درس

  • کلید مدیریتی برای خودکار کردن کار است و به مدل‌ها دسترسی ندارد.
  • Webhook رویدادها را به سرور شما می‌فرستد.
  • با BYOK کلید خودتان را روی زیرساخت ما به کار می‌برید.
چک‌لیست پیش از انتشارده دقیقه بررسی، جلوی یک شب بد را می‌گیرد.تمام کردم، درس بعد