۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

تیم‌ها و بودجه‌ها: حساب شرکتی، نقش‌ها و سقف ماهانه

حساب شرکتی یک کیف پول مشترک دارد و به فضاهای کاری تقسیم می‌شود. هر عضو یکی از ۵ نقش را دارد. کلیدی که در یک فضای کاری ساخته می‌شود از کیف پول شرکت خرج می‌کند. برای هر فضای کاری و هر عضو می‌شود سقف ماهانه گذاشت، به تومان و به تعداد درخواست؛ کلیدی که به سقف برسد پاسخ 401 با کد workspace_limit می‌گیرد تا ماه بعد.

آخرین به‌روزرسانی:

فهرست مستندات

تیم‌ها و بودجه‌ها · ۱

حساب شرکتی و فضای کاری

  • شرکت یک کیف پول و یک پلن مشترک دارد که جدا از کیف پول شخصی اعضاست.
  • شرکت به فضاهای کاری تقسیم می‌شود (مثلاً یک فضا برای هر تیم یا هر محصول). کلیدها، مصرف و سقف‌ها به فضای کاری تعلق دارند.
  • شمار اعضا و فضاهای کاری سقفی ندارد.
  • هر حساب کاربری می‌تواند تا ۳ شرکت بسازد. دعوت‌نامهٔ عضو تازه ۷ روز اعتبار دارد.

شرکت را در داشبورد، بخش «تنظیمات › شرکت» (/settings/company) می‌سازی و مدیریت می‌کنی.

تیم‌ها و بودجه‌ها · ۲

نقش‌ها

هر نقش چه کاری می‌تواند بکند
کارowneradminbillingdeveloperviewer
دیدن گزارش مصرف فضای کاری خودشبلهبلهبلهبلهبله
ساختن و باطل کردن کلید فضای کاریبلهبلهنهبلهنه
دیدن مصرف کل شرکتبلهبلهبلهنهنه
شارژ کیف پول، خرید پلن، فاکتور و پیش‌فاکتوربلهبلهبلهنهنه
گذاشتن سقف ماهانه برای فضای کاری و اعضابلهبلهبلهنهنه
ساختن فضای کاری و تعیین بودجهٔ آنبلهبلهنهنهنه
دعوت و حذف اعضا، تغییر نقش، دسترسی فضاهابلهبلهنهنهنه
واگذاری مالکیت شرکتبلهنهنهنهنه

developer فقط در فضاهایی که به آن‌ها دسترسی داده شده کلید می‌سازد. owner و admin به همهٔ فضاها دسترسی دارند.

تیم‌ها و بودجه‌ها · ۳

کلید فضای کاری

  • کلید فضای کاری همان شکل کلید شخصی را دارد و روی همان مسیرها کار می‌کند.
  • هزینهٔ تماس‌هایش از کیف پول (و پلن) شرکت کم می‌شود، نه از کیف پول کسی که آن را ساخته. سازندهٔ کلید کنار هر تماس ثبت می‌شود.
  • تاریخ انقضا و سقف خرج دارد، مثل هر کلید دیگر (کلیدها و امنیت).
  • کلید با هر درخواست دوباره سنجیده می‌شود. اگر فضای کاری غیرفعال یا شرکت معلق شود، اگر عضویت سازندهٔ کلید غیرفعال شود، یا اگر او دیگر نقش owner‏، admin یا developer آن فضا را نداشته باشد، کلید پاسخ 401 با کد key_revoked می‌گیرد.
  • وقتی owner یا admin عضوی را حذف می‌کند، کلیدهای آن عضو به نام حذف‌کننده منتقل می‌شوند و به کار ادامه می‌دهند.

API حساب با کلید فضای کاری

در API حساب کلید فضای کاری فقط دادهٔ همان فضای کاری را می‌خواند: تماس‌های آن فضا (همهٔ اعضا، از API و از محصول چت) و کلیدهای آن فضا، و از کیف پول شرکت فقط اعتبار قابل خرج (GET /v1/wallet/summary). ریز تراکنش‌های کیف پول مال کل شرکت است و در داشبورد شرکت دیده می‌شود؛ GET /v1/wallet/transactions با کلید فضای کاری پاسخ 403 با کد forbidden می‌گیرد. متن ثبت‌شدهٔ درخواست و پاسخ فقط برای تماس‌هایی برمی‌گردد که با کلید API فرستاده شده‌اند، نه برای آنچه در چت نوشته شده. کلید شخصی هم فقط تماس‌ها و کلیدهای بیرون از فضاهای کاری شرکت را می‌خواند.

تیم‌ها و بودجه‌ها · ۴

سقف‌های ماهانه

سقف‌هایی که می‌شود گذاشت
سقفروی چهواحد
بودجهٔ ماهانهٔ فضای کاریکل خرج فضا: API و چت با همتومان
سقف ماهانهٔ API فضای کاریخرج کلیدهای API آن فضاتومان
سقف ماهانهٔ چت فضای کاریخرج چت اعضا در آن فضاتومان
سقف ماهانهٔ درخواست فضای کاریشمار درخواست‌های آن فضاتعداد
سقف پیش‌فرض هر عضو (API و چت)هر عضوی که سقف خودش را نداردتومان
سقف یک عضو: API، چت، درخواستهمان عضو در همان فضاتومان و تعداد
  • سقف خالی یعنی بدون محدودیت. هیچ سقفی به‌طور پیش‌فرض گذاشته نشده است.
  • ماه، ماه تقویمی میلادی به وقت UTC است و شمارنده‌ها نیمه‌شب UTC روز اول ماه صفر می‌شوند.
  • اگر عضوی سقف درخواست خودش را داشته باشد، همان اعمال می‌شود و سقف درخواست فضای کاری برای او سنجیده نمی‌شود.
  • شمار درخواست‌ها هر تماس ثبت‌شده با کلید آن فضا را می‌شمارد.

تیم‌ها و بودجه‌ها · ۵

وقتی سقف پر می‌شود

http
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8

{
  "error": {
    "message": "The workspace or member monthly usage limit has been reached.",
    "type": "api_error",
    "code": "workspace_limit"
  }
}
  • سقف پیش از هر تماس و با مصرف تسویه‌شده تا همان لحظه سنجیده می‌شود. تماسی که از سقف می‌گذرد کامل انجام و حساب می‌شود و تماس‌های بعدی رد می‌شوند.
  • کلید باطل نمی‌شود: با شروع ماه بعد، یا وقتی سقف را بالا ببری، دوباره کار می‌کند.
  • این پاسخ 401 است، نه 402 و نه 429؛ در برنامه‌ات آن را با کد workspace_limit بشناس، نه با وضعیت HTTP.

تیم‌ها و بودجه‌ها · ۶

هشدار بودجه

وقتی مصرف یک فضای کاری به ۸۰٪ و سپس به ۱۰۰٪ یکی از سقف‌های ماهانه‌اش برسد، به owner‏، admin و billing شرکت ایمیل فرستاده می‌شود؛ هر کدام یک بار در ماه.

تیم‌ها و بودجه‌ها · ۷

شارژ و فاکتور شرکت

  • کیف پول شرکت را owner‏، admin و billing شارژ می‌کنند، با همان روش‌ها و همان مالیات بر ارزش افزودهٔ ۱۰٪ که در صورت‌حساب آمده است.
  • برای هر پرداخت موفق فاکتور صادر می‌شود. برای فاکتور رسمی، نام حقوقی، شناسهٔ ملی، کد اقتصادی، نشانی و کد پستی شرکت را در پروفایل مالی وارد کن.
  • پیش‌فاکتور را پیش از پرداخت می‌توانی بگیری.