درس ~6 دقیقه

اتصال به API خارجی (سینک به جدول)

با ویزارد Pull-Sync، رکوردهای یک REST API را زمان‌بندی‌شده به یک جدول بازوان می‌ریزید — نمونه: رهگنج.

در تب «داده‌های ورودی»، دکمهٔ «اتصال به API خارجی» ویزارد ۴ مرحله‌ای را باز می‌کند: تعریف اتصال، کشف ساختار، انتخاب مقصد، زمان‌بندی.

میان‌بر رهگنج

روی «اتصال سریع به رهگنج» بزنید تا آدرس، مسیر آرایه، صفحه‌بندی و اسکلت هدر Authorization پیش‌پُر شود. فقط توکن Bearer را که از پنل رهگنج گرفته‌اید (rgj_live_…) جای‌گزین کنید.

کشف از OpenAPI

اگر API مقصد فایل openapi.json دارد، به‌جای حدس از نمونه، مستقیم از schema فیلدها را استخراج کنید — دقیق‌تر و بدون حدس نوع.

احترام به سقف نرخ

اگر API پاسخ 429 بدهد، Worker مطابق هدر Retry-After صبر می‌کند (حداکثر دو بار در هر ران). اگر باز هم rate-limited باشد، به‌جای خطا، ادامه به تیک بعدی موکول می‌شود.

برای تست، ابتدا page_size=5 و max_pages=1 بگذارید و «اجرای اول» را بزنید تا خروجی را در «لاگ ورودی» ببینید. سپس مقادیر واقعی را تنظیم کنید.