پاسخی که جمله آخرش تمام شده ممکن است هنوز بخشی از درخواست را پوشش نداده باشد. برای تشخیص خروجی نصفه، هم وضعیت پایان سرویس و هم کاملبودن محتوای موردنیاز را بررسی کنید. قطع شبکه، رسیدن به سقف خروجی و پاسخ کوتاه عمدی علتهای متفاوت دارند و راه ادامه یکسان ندارند.
روش اجرا و تصمیمگیری
نام دقیق وضعیت پایان را از مستندات API همان نسخه بگیرید. قرارداد برنامه باید پایان طبیعی، محدودیت طول، لغو و خطا را از هم جدا کند. اگر سرویس وضعیت روشن نداده، برنامه نباید صرف بستهشدن اتصال، کار را کامل بداند.
برای خروجی ساختاریافته، شمار اقلام و schema را کنترل کنید. JSON بریده را با افزودن یک آکولاد معتبر فرض نکنید؛ ممکن است ردیفهای لازم حذف شده باشند. برای متن آزاد، فهرست بخشهای درخواستشده را با پاسخ تطبیق دهید و موارد پوششدادهنشده را مشخص کنید.
اگر ادامه لازم است، زمینه و شناسه اجرای قبلی را حفظ کنید. مدل ممکن است در ادامه، بخشی را تکرار یا معنا را عوض کند؛ نسخه نهایی باید دوباره یکپارچه بررسی شود. اقدام بیرونی بر اساس خروجی ناقص تا تکمیل و تأیید متوقف بماند. گزینه خلاصهتر گرفتن نیز باید با رضایت روشن و حفظ اطلاعات ضروری انجام شود.
نمونهٔ ساختگی و قابل تکرار
در مثال ساختگی، درخواست استخراج پنج الزام داریم ولی پاسخ فقط سه ردیف و وضعیت پایان طول دارد. برنامه نتیجه را ناقص میگذارد، سه ردیف را نگه میدارد و برای ادامه مجاز از بخش باقیمانده استفاده میکند. پس از دریافت، شناسهها کنترل میشوند تا ردیف چهارم تکرار ردیف سوم نباشد. اگر فقط نشانه ظاهری بستهشدن جدول اضافه میشد، خروجی از نظر نمایش کامل ولی از نظر پوشش ناقص میماند. هیچ ادعای موفقیت کامل قبل از این کنترل ثبت نمیشود.
محدودیتها و خطاهای رایج
کاملبودن ساختار به معنی درستی ادعا نیست. محتوای نهایی همچنان شاهد و بازبین لازم دارد. افزایش سقف خروجی میتواند مصرف را تغییر دهد و نباید بدون بودجه و محدودیت مدل انجام شود؛ اعداد و نام وضعیتها در سرویسهای مختلف یکسان نیستند.
کنترل پیش از استفاده
| کنترل | معیار پذیرش |
|---|---|
| پایان | وضعیت سرویس و علت توقف کنار پاسخ ذخیره شوند. |
| پوشش | تعداد و بخشهای موردنیاز با خروجی نهایی تطبیق داده شوند. |
| ادامه | نسخه ترکیبشده برای تکرار، تعارض و ساختار دوباره کنترل شود. |
کاربرگ همراه
کاربرگ فهرست پوشش خروجی است. بخشهای لازم را پیش از ارسال درخواست بنویسید تا بعداً مطابق پاسخ ناقص تغییر نکنند. اگر علت توقف روشن نیست، آن را نامشخص نگه دارید و از حدس وضعیت موفق خودداری کنید.
دریافت کاربرگ CSV این راهنما — دادههای داخل فایل نمونهٔ ساختگیاند. نسخهٔ اصلی را نگه دارید و برای آزمون خودتان یک کپی بسازید.
منبع و ادامهٔ کار
JSON Schema: شیء و فیلدها؛ MDN: رویداد ارسالی سرور. تاریخ بررسی منابع: ۱ نوامبر ۲۰۲۶.
اگر کاربرد شما پاسخگویی به مشتری است، مسیر مرتبط اپرا را ببینید و مسئله و محدودیتهای همین کاربرگ را برای بررسی در دمو همراه داشته باشید.