قابلیت · موات
هر چیزی که در پنل هست، در API هم هست
بیش از ۲۵۰ اندپوینت مستند، توکن با محدودهٔ دقیق، وبهوک با امضای زماندار، و قراردادی که تغییرش عمدی است.
چرا API ما بیصدا تغییر نمیکند
قرارداد OpenAPI بهصورت یک snapshot در مخزن نگهداری میشود. هر تغییری در هر مسیر، تا وقتی آن snapshot عمداً بازتولید نشود، build را میشکند.
یعنی تغییر API غیرممکن نیست — ولی تصادفی هم نیست. کسی که تغییر میدهد، مجبور است ببیند دقیقاً چه چیزی عوض شد.
- مستندسازی
- OpenAPI کامل، قابل بارگذاری در ابزارهای استاندارد
- نسخهبندی
- مسیرها با پیشوند نسخه
- اعتبارسنجی سختگیرانه
- فیلد ناشناخته رد میشود، نه نادیده گرفته
- صفحهبندی
- روی فهرستها، با ترتیب قطعی
- خطای نوعدار
- کد خطای مشخص، نه پیام رشتهای
احراز هویت
| روش | کاربرد |
|---|---|
| JWT | نشست کاربر |
| توکن API با محدوده | اتوماسیون، CI، ابزار |
| هویت بار کاری | سرویس-به-سرویس، بدون رمزِ حملشونده |
محدودهٔ توکن
خواندن / نوشتن / استقرار — بهصورت جدا قابل تخصیص. توکنی که فقط خواندن دارد، حتی اگر دزدیده شود، نمیتواند چیزی را خراب کند.
وبهوک
| جهت | جزئیات |
|---|---|
| ورودی | دریافت رویداد از ارائهدهندهٔ گیت، با راستیآزمایی امضا |
| خروجی | ارسال رویداد پلتفرم به سامانههای شما |
- امضای HMAC
- با زمان داخل امضا، نه کنارش
- شناسهٔ تحویل ثابت
- در همهٔ تلاشهای مجدد یکسان، تا حذف تکراری معنا داشته باشد
- فهرست میزبان مجاز
- فقط مقصدهای تأییدشده
- تاریخچه
- هر تلاش با نتیجه و کد پاسخ
- تلاش مجدد
- با backoff، و در نهایت صف نامههای مرده
رویدادها
- اپلیکیشن
- بیلد شروع/موفق/ناموفق، استقرار، بازگشت
- ماشین مجازی
- ساخت، روشن/خاموش، مهاجرت، اسنپشات
- امنیت
- تلاش ناموفق ورود، کلید اضطراری، تغییر دسترسی
- زیرساخت
- نود اضافه/حذف، هشدار سلامت
- هزینه
- عبور از آستانهٔ بودجه
- انطباق
- کنترل مردود، ناسازگاری زنجیره
حالتها
متن واقعی رابط کاربری در هر وضعیت. حالت خالی، در حال انجام، و خطا، به همان شکلی که کاربر میبیند.
- توکن منقضی
این توکن منقضی شده است.
- محدودهٔ ناکافی
این توکن فقط دسترسی خواندن دارد.
- وبهوک ناموفق
۳ تلاش ناموفق برای این مقصد، با کد پاسخ ثبتشده.
تلاش مجدد — نمونهٔ دکمهٔ رابط کاربری، در این صفحه فعال نیست
- میزبان غیرمجاز
این مقصد در فهرست مجاز نیست.
- محدودیت نرخ
تعداد درخواست بیش از حد مجاز.
اینها را هم ببینید
این را روی زیرساخت خودتان ببینید.
یک جلسهٔ ۴۵ دقیقهای، محصول واقعی، بدون اسلاید.