گردشکار اخبار در n8n؛ از درخواست HTTP تا خروجی قابل کنترل
یک گردشکار خبری خوب فقط درخواست موفق تولید نمیکند. باید بداند چه دادهای دریافت شده و چه چیزی مصرف شده است. n8n میتواند با گره HTTP Request به API متصل شود.
هدف گردشکار
یک گردشکار خبری خوب فقط درخواست موفق تولید نمیکند. باید بداند چه دادهای دریافت شده و چه چیزی مصرف شده است. n8n میتواند با گره HTTP Request به API متصل شود. این اتصال عمومی را خودتان بیرون از khapi میسازید. نخست خروجی را در محیط آزمایشی نگه دارید.
طراحی مسیر ساده
مسیر اولیه شامل اجرا، دریافت، اعتبارسنجی و ذخیره باشد. ارسال ایمیل یا پیام را به مرحله بعد موکول کنید. هر مرحله باید خروجی قابل مشاهده داشته باشد. در صورت خطا، مسیر عادی نباید ادامه پیدا کند. سادگی نسخه نخست، یافتن علت مشکل را آسانتر میکند.
تنظیم درخواست
روش را GET و مسیر را /api/v1/news قرار دهید. کلید را با اعتبارنامه مناسب در هدر x-api-key بفرستید. page_size و بازه تاریخ را صریح تعیین کنید. مقدارهای آزمایشی را با کلید واقعی در فایل نمونه ذخیره نکنید. نام دقیق گزینههای رابط ممکن است با نسخه تغییر کند.
تبدیل آرایه به اقلام
در پاسخ موفق، خبرها داخل articles قرار میگیرند. هر عضو را به یک قلم برای مرحله بعد تبدیل کنید. اطلاعات صفحهبندی را پیش از این تبدیل نگه دارید. پاسخ خالی باید به پایان عادی مسیر منجر شود. نبود خبر با شکست دریافت یکسان نیست.
نگهداری وضعیت
شناسه خبرهای پردازششده را در محل پایدار ثبت کنید. حافظه موقت اجرای جاری برای جلوگیری از تکرار کافی نیست. وضعیت را پس از موفقیت مرحله مصرف بهروزرسانی کنید. اگر زودتر ثبت شود، شکست ارسال میتواند خبر را جا بیندازد. برای بازیابی، زمان و علت شکست را هم نگه دارید.

زمانبندی و صفحهها
دفعات اجرا را براساس نیاز و بودجه درخواست انتخاب کنید. صفحههای هر اجرا باید سقف و شرط توقف داشته باشند. برای دریافت افزایشی، پنجره همپوشان و حذف تکرار طراحی کنید. صفحهبندی روی مجموعه در حال تغییر، تضمین کامل بودن نمیدهد. این محدودیت را در طراحی مصرفکننده لحاظ کنید.
مدیریت خطا
خطای اعتبارنامه با خطای موقت شبکه رفتار یکسانی نمیخواهد. در محدودیت سهمیه، تلاش بیپایان مسئله را حل نمیکند. زمان تلاش بعدی و تعداد تکرار را محدود کنید. اگر Retry-After وجود دارد، معنای آن را رعایت کنید. لاگ خطا نباید هدر حاوی کلید را افشا کند.
ارسال آزمایشی
پیش از فعال کردن مقصد واقعی، خروجی را پیشنمایش کنید. یک خبر تکراری و یک نتیجه نامرتبط در آزمون بگذارید. مشخص کنید کدام فیلتر از ارسال جلوگیری میکند. ارسال واقعی باید فقط به مقصد مجاز و موردانتظار باشد. تعداد پیامهای هر اجرا را با سقف مشخص کنترل کنید.
معیار پذیرش
اجرای دوباره نباید بدون دلیل خروجی تکراری بسازد. شکست مقصد باید قابل مشاهده و قابل پیگیری باشد. داده خالی نباید اعلان خطای کاذب تولید کند. مصرف درخواست در چند اجرای آزمایشی ثبت شود. این آزمونها از روشن بودن ساده گردشکار مهمتر هستند.
شروع با مستندات khapi
یک درخواست نمونه را با فیلتر موضوع خود تطبیق دهید. آن را در گره HTTP Request وارد و دستی اجرا کنید. پس از تأیید داده، ذخیره وضعیت و زمانبندی را اضافه کنید. تا پیش از آزمون مقصد، اعلان انبوه را فعال نکنید. گردشکار زمانی آماده است که شکستهای قابل انتظار هم مدیریت شوند.
منابع و ادامه مطالعه
این مطلب چطور به کار شما بیاید؟
مفاهیم این مقاله را مستقیم در پنل khapi امتحان کنید:
آماده شروع هستید؟
۳ روز استفادهٔ رایگان از پنل تحلیلگر، مطابق محدودیتهای دورهٔ آزمایشی و بدون نیاز به کارت بانکی.