تیمها و بودجهها: حساب شرکتی، نقشها و سقف ماهانه
حساب شرکتی یک کیف پول مشترک دارد و به فضاهای کاری تقسیم میشود. هر عضو یکی از ۵ نقش را دارد. کلیدی که در یک فضای کاری ساخته میشود از کیف پول شرکت خرج میکند. برای هر فضای کاری و هر عضو میشود سقف ماهانه گذاشت، به تومان و به تعداد درخواست؛ کلیدی که به سقف برسد پاسخ 401 با کد workspace_limit میگیرد تا ماه بعد.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
تیمها و بودجهها · ۱
حساب شرکتی و فضای کاری
- شرکت یک کیف پول و یک پلن مشترک دارد که جدا از کیف پول شخصی اعضاست.
- شرکت به فضاهای کاری تقسیم میشود (مثلاً یک فضا برای هر تیم یا هر محصول). کلیدها، مصرف و سقفها به فضای کاری تعلق دارند.
- شمار اعضا و فضاهای کاری سقفی ندارد.
- هر حساب کاربری میتواند تا ۳ شرکت بسازد. دعوتنامهٔ عضو تازه ۷ روز اعتبار دارد.
شرکت را در داشبورد، بخش «تنظیمات › شرکت» (/settings/company) میسازی و مدیریت میکنی.
تیمها و بودجهها · ۲
نقشها
| کار | owner | admin | billing | developer | viewer |
|---|---|---|---|---|---|
| دیدن گزارش مصرف فضای کاری خودش | بله | بله | بله | بله | بله |
| ساختن و باطل کردن کلید فضای کاری | بله | بله | نه | بله | نه |
| دیدن مصرف کل شرکت | بله | بله | بله | نه | نه |
| شارژ کیف پول، خرید پلن، فاکتور و پیشفاکتور | بله | بله | بله | نه | نه |
| گذاشتن سقف ماهانه برای فضای کاری و اعضا | بله | بله | بله | نه | نه |
| ساختن فضای کاری و تعیین بودجهٔ آن | بله | بله | نه | نه | نه |
| دعوت و حذف اعضا، تغییر نقش، دسترسی فضاها | بله | بله | نه | نه | نه |
| واگذاری مالکیت شرکت | بله | نه | نه | نه | نه |
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/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 شارژ میکنند، با همان روشها و همان مالیات بر ارزش افزودهٔ ۱۰٪ که در صورتحساب آمده است.
- برای هر پرداخت موفق فاکتور صادر میشود. برای فاکتور رسمی، نام حقوقی، شناسهٔ ملی، کد اقتصادی، نشانی و کد پستی شرکت را در پروفایل مالی وارد کن.
- پیشفاکتور را پیش از پرداخت میتوانی بگیری.