API
بک‌اند ابری api.eyeban.ir در برابر Local API روی 127.0.0.1:17300.
ایبان دو سطح API متفاوت دارد. بک‌اند ابری محصول را با یک پلتفرم عمومی توسعه‌دهندهٔ ثالث اشتباه نگیرید.
API ابری (api.eyeban.ir)
فضای کار دسکتاپ برای این‌ها به api.eyeban.ir وصل می‌شود:
- احراز هویت و نشست
- اجرای ایجنت روی SSE
- مسیریابی مدل و entitlementها
- وضعیت حساب / کیف اعتبار
این بک‌اند خود برنامه است. مسیرهای مستندنشدهٔ ابر را داخلی فرض کنید. روی مسیرهای مهندسی‌معکوس یکپارچه‌سازی production نسازید.
API محلی (127.0.0.1:17300)
وقتی فعال باشد، فضای کار یک API محلی روی 127.0.0.1:17300 برای ابزار همان ماشین ارائه می‌دهد. گروه‌های endpoint شامل:
- status — آمادگی / وضعیت فرایند
- tasks — فهرست کار محلی
- files — عملیات فایل فضای کاری
- search — جستجو روی ایندکس محلی
- git — کمک‌های SCM
- terminals — هوک نشست ترمینال
- agent — سطح کنترل ایجنت محلی
- permissions — وضعیت مجوز
- tools — فهرست / کمک فراخوانی ابزار محلی
API محلی به‌صورت پیش‌فرض به اینترنت عمومی باز نیست. بی‌احتیاط port-forward نکنید. bind روی loopback دلیل دارد.
احراز هویت و ایمنی
فراخوانی Local API فرض می‌کند کاربر روی همان ماشین قابل‌اعتماد است. فراخوانی ابر به حساب ایبان واردشده نیاز دارد. کوکی نشست را در اسکریپت‌هایی که کنترل نمی‌کنید paste نکنید.
راهنما
کار روزمره را در UI فضای کار انجام دهید. Local API را برای اتوماسیون کنترل‌شدهٔ محلی نگه دارید. ابر را فقط از طریق کلاینت واردشده استفاده کنید مگر بعداً قرارداد HTTP عمومی پایدار در همین صفحه اعلام شود.