پرش به محتوای اصلی
یک شروع رایگان برای شما

۳ روز رایگان،
پنل تحلیلگر را تجربه کنید

ثبت‌نام کنید و با تأیید شماره موبایل، دسترسی آزمایشی سه‌روزه‌تان را فعال کنید.

✓ بدون نیاز به پرداخت✓ فعال‌سازی پس از تأیید موبایل
شروع رایگان ۳ روزه

ویژه کاربران جدید · یک دوره برای هر حساب

صفحه‌بندی API اخبار؛ چگونه خبرها را جا نیندازیم؟

فهرست اخبار هنگام دریافت صفحات می‌تواند تغییر کند. خبر تازه در ابتدای نتایج، جای رکوردهای بعدی را جابه‌جا می‌کند. بنابراین صفحه دوم همیشه ادامه ثابت صفحه اول نیست.

تیم khapi · ۲۰ آبان ۱۴۰۵ · ۳ دقیقه مطالعه
تصویر مفهومی چند صفحه خبر شماره‌گذاری‌نشده روی میز که کارت تازه‌ای ابتدای آن‌ها اضافه می‌شود

چرا صفحه‌بندی حساس است؟

فهرست اخبار هنگام دریافت صفحات می‌تواند تغییر کند. خبر تازه در ابتدای نتایج، جای رکوردهای بعدی را جابه‌جا می‌کند. بنابراین صفحه دوم همیشه ادامه ثابت صفحه اول نیست. دریافت موفق همه صفحات، به‌تنهایی کامل بودن را ثابت نمی‌کند. مصرف‌کننده باید این تغییرپذیری را در طراحی لحاظ کند.

قرارداد صفحه‌ها

در khapi، page و page_size اندازه دریافت را تعیین می‌کنند. پاسخ شامل total_results، total_pages و articles است. page_size حداکثر صد است. از نام‌های رسمی در اتصال تازه استفاده کنید. اطلاعات صفحه‌بندی را کنار زمان اجرای درخواست نگه دارید.

پنجره زمانی ثابت

پیش از شروع اجرا، مرز پایان بازه را مشخص کنید. همان from_date و to_date را برای همه صفحات بفرستید. این کار ورود خبرهای جدیدتر را از بازه جدا می‌کند. بااین‌حال ورود دیرهنگام یا اصلاح داده هنوز ممکن است رخ دهد. پنجره ثابت، تضمین snapshot تراکنشی ایجاد نمی‌کند.

ترتیب قابل پیش‌بینی

ترتیب نتایج را مطابق رفتار مستند سرویس در نظر بگیرید. زمان یکسان برای چند خبر می‌تواند مسئله مرزی بسازد. در khapi، شناسه خبر برای حذف تکرار مصرف‌کننده مفید است. ترتیب مشاهده‌شده را قرارداد دائمیِ اعلام‌نشده فرض نکنید. کد باید در برابر جابه‌جایی محدود رکوردها مقاوم باشد.

شناسه یکتا

رکوردهای دریافت‌شده را با id در آرشیو تطبیق دهید. درج دوباره همان شناسه نباید ردیف مستقل تازه بسازد. اگر داده تغییر کرده، سیاست به‌روزرسانی مشخص داشته باشید. عنوان به‌تنهایی کلید مناسبی برای هویت خبر نیست. چند خبر مستقل می‌توانند تیتر یکسان داشته باشند.

نمودار توضیحی دو پنجره زمانی هم‌پوشان با کارت‌های مشترک همرنگ

دریافت افزایشی

در اجرای بعد، بخشی از بازه قبلی را دوباره بررسی کنید. طول هم‌پوشانی باید با تأخیر مشاهده‌شده تنظیم شود. این هم‌پوشانی برخی ورودهای دیرهنگام را قابل کشف می‌کند. تکرارهای ناشی از آن با شناسه کنترل می‌شوند. هیچ طول ثابت و دلخواه، پوشش کامل را تضمین نمی‌کند.

شرط توقف

تعداد صفحات، زمان اجرا و بودجه درخواست سقف داشته باشند. اگر آرایه خالی شد، وضعیت را ثبت و مسیر را بررسی کنید. تغییر total_pages میان درخواست‌ها را نادیده نگیرید. در شکست یک صفحه، پیشرفت را قطعی و کامل اعلام نکنید. اجرای بعد باید نقطه بازیابی مشخصی داشته باشد.

نمونه فرضی خطا

فرض کنید بین دو درخواست، سه خبر به ابتدای فهرست اضافه شود. بعضی رکوردهای صفحه اول ممکن است دوباره در صفحه دوم بیایند. حذف تکرار، شمار اضافی را کنترل می‌کند. اما خبر جاافتاده به بازبینی پنجره و هم‌پوشانی نیاز دارد. این مثال تفاوت جلوگیری از تکرار و تضمین جامعیت را نشان می‌دهد.

آزمون مصرف‌کننده

پاسخ‌های چندصفحه‌ای را در فایل نمونه ذخیره کنید. حالت جابه‌جایی، صفحه خالی و تکرار شناسه را شبیه‌سازی کنید. شمار نهایی را با شناسه‌های مورد انتظار مقایسه کنید. خطای وسط اجرا نباید آرشیو موفق قبلی را پاک کند. گزارش آزمون باید موارد ناتمام را هم نشان دهد.

شروع محدود با khapi

ابتدا بازه کوتاه و موضوع کم‌حجم انتخاب کنید. تعداد رکورد خام و یکتا را ثبت کنید. سپس دریافت افزایشی و هم‌پوشانی را به برنامه اضافه کنید. نیاز به جامعیت سخت‌گیرانه را با ارائه‌دهنده سرویس مطرح کنید. طراحی قابل توضیح از ادعای دریافت بی‌نقص مهم‌تر است.

منابع و ادامه مطالعه

اشتراک‌گذاری:

این مطلب چطور به کار شما بیاید؟

مفاهیم این مقاله را مستقیم در پنل khapi امتحان کنید:

آماده شروع هستید؟

۳ روز استفادهٔ رایگان از پنل تحلیلگر، مطابق محدودیت‌های دورهٔ آزمایشی و بدون نیاز به کارت بانکی.