آمادهسازی محصول
الگوهای عملی برای اتصال پایدار و قابل پیگیری.
جریان کار کاربر را کامل کنید
قبل از ارسال، ورودی را بررسی و دکمه را در وضعیت در حال اجرا قرار دهید. شناسهٔ درخواست را پس از پذیرش ذخیره کنید. اگر اتصال قطع شد، متن ورودی را نگه دارید و یک اقدام روشن برای بررسی وضعیت نشان دهید. spinner دائمی بدون وضعیت قابل بازیابی تجربهٔ مناسبی نیست.
تنظیم کلید و بودجه
برای هر محیط کلید جدا بسازید و حداقل دسترسی لازم را بدهید. سقف درخواست در دقیقه و سقف اعتبار را با ظرفیت واقعی محصول تطبیق دهید. کلید را در secret manager یا محیط امن سرور نگه دارید و چرخش کلید را بدون قطع محصول تمرین کنید.
صف و کار طولانی
برای ویدیو و Work ابتدا کار را ثبت و شناسه را در پایگاه دادهٔ برنامهٔ خود ذخیره کنید. polling با فاصلهٔ افزایشی انجام دهید. وضعیت completed را از دریافت فایل تفکیک کنید؛ دانلود ناموفق یک خروجی آماده نباید تولید دوباره را شروع کند.
اندازهگیری معنیدار
نرخ خطا، زمان پاسخ، هزینهٔ واقعی و کیفیت خروجی را برای مسیرهای اصلی خودتان اندازه بگیرید. سالم بودن endpoint مدلها یا یک پاسخ HTTP 200 آزمون کیفیت تمام مدلها نیست. برای تغییر مدل، مجموعهٔ کوچکی از درخواستهای واقعی و قابل مقایسه نگه دارید.
نسخه و سازگاری
این قرارداد در /v1 نسخهبندی شده است. فیلدهای جدید پاسخ را تحمل کنید، ولی فیلدهای ورودی ناشناخته نفرستید. برای وابستگی به یک قابلیت، آن را در مرجع Sarovi بررسی کنید؛ شباهت نام responses با API دیگر به معنی سازگاری کامل تمام SDKها نیست.
قرارداد API 1.6.0 · تاریخچهٔ تغییرات