اتصال هر چیز
HTTP ورودی، HTTP خروجی، بخش‌های دشوار حل‌شده
هر ابزار اتوماسیونی عددی از یکپارچه‌سازی‌ها تبلیغ می‌کند. این عدد همیشه بزرگ است و همیشه پرسش اشتباهی است، چون سامانه‌ای که واقعاً به آن نیاز دارید همان است که در سال ۲۰۱۴ کسی که رفته، درون‌ساخت داده است. آنچه اهمیت دارد این است که ابزار چقدر خوب با پروتکل زیربنایی همه آن‌ها صحبت می‌کند.
اتصال‌های آماده
کاربردهایی که بیشتر کسب‌وکارها بر آن‌ها می‌چرخند گام‌های آماده دارند: فروشگاه‌ها و بازارگاه‌ها، حسابداری و صورتحساب، صفحه‌گسترده‌ها و پایگاه‌های داده، تقویم‌ها و رایانامه، ذخیره‌سازی و پیام‌رسانی، CRMها و میزهای کمک، ارائه‌دهندگان پرداخت و شرکت‌های حمل‌ونقل. حساب را یک بار مجاز می‌کنید و فیلدها با زبانی که خود کاربرد به کار می‌برد نام‌گذاری شده‌اند، نه با زبان JSON آن.
جایی که کاربردی ویژگی خاص بازار لهستان دارد — سامانه صورتحسابی که باید با KSeF سازگار باشد، شرکتی که برچسب‌هایش استاندارد ملی است — گام آماده از آن خبر دارد، چون خانواده به آن بازار می‌فروشد و ناچار به یادگیری آن شده است.
و سپس حالت عمومی
هر چیز دیگر یک گام HTTP است، و گام HTTP در اینجا جایزه تسلی‌بخش نیست. همان سازوکاری است که اتصال‌های آماده بر آن ساخته شده‌اند، با همان رسیدگی به بخش‌هایی که نوشتنشان به‌تنهایی خسته‌کننده است.
بخش‌های خسته‌کننده
حل‌شده، تا شما دوباره ننویسیدشان
احراز هویت
کلیدهای API، توکن‌های bearer، احراز هویت پایه، OAuth 2 با تازه‌سازی، امضای درخواست با HMAC، TLS دوطرفه. اعتبارنامه یک بار ذخیره می‌شود، با نام به آن ارجاع می‌شود و هرگز در لاگ یا رکورد اجرا چاپ نمی‌شود.
صفحه‌بندی
نشانگرها، شماره صفحه‌ها، آفست‌ها، سربرگ‌های Link، و APIای که پایان را با بازگرداندن آرایه خالی اعلام می‌کند. بگویید کدام شکل است و گام کل مجموعه را می‌پیماید.
محدودیت نرخ
سقفی برای هر اتصال، که در همهٔ گردش‌کارهایی که از آن استفاده می‌کنند رعایت می‌شود. وقتی ارائه‌دهنده با 429 و Retry-After پاسخ می‌دهد، گام به همان اندازه صبر می‌کند و پشت‌سرهم در نمی‌زند.
تلاش مجدد و فاصله‌گذاری تدریجی
خطاهای گذرا با فاصلهٔ فزاینده و یک سقف دوباره تلاش می‌شوند. هر گام تابعی خالص از ورودی‌هایش است، پس تلاش مجدد همان گام را دوباره اجرا می‌کند، نه کل اجرا را.
بارهای نامهٔ دشوار
JSON، کدگذاری فرم، XML، متن ساده، بارگذاری‌های multipart. پاسخ‌ها به فیلدهایی تجزیه می‌شوند که می‌توانید با نام به آن‌ها ارجاع دهید، حتی آن‌هایی که چهار سطح پایین‌تر تودرتو شده‌اند.
مهلت‌های زمانی
محدودیتی برای هر گام، تا یک وابستگی کند نتواند یک کارگر را نگه دارد در حالی که همهٔ کارهای پشت آن در صف می‌مانند. اینکه وقتی مهلت تمام می‌شود چه اتفاقی بیفتد، تصمیم شماست، برای هر گام.
اگر با HTTP حرف می‌زند، گفتگو از قبل آغاز شده است.
وب‌هوک‌های ورودی، جدی گرفته می‌شوند
هر گردش‌کار می‌تواند نشانی‌ای داشته باشد که آن را آغاز می‌کند. آن نشانی امضاها را بررسی می‌کند — HMAC در قالب‌هایی که ارائه‌دهندگان رایج استفاده می‌کنند، و یک رمز مشترک جایی که تنها همین از فرستنده برمی‌آید. درخواستِ بدون امضا به گردش‌کاری که امضا انتظار دارد رد و ثبت می‌شود، نه اینکه بی‌سروصدا پردازش شود.
حذف موارد تکراری بر پایهٔ شناسهٔ خودِ بار انجام می‌شود، تا فرستنده‌ای که چون 200 شما را به‌موقع ندید دوباره تلاش می‌کند، یک اجرا بگیرد نه سه تا. بارهای بدشکل نگه داشته می‌شوند، همراه با دلیل ردشدشان، زیرا رایج‌ترین علتِ شکافِ مرموز در یک اتوماسیون، فرستنده‌ای است که نظرش دربارهٔ یک فیلد عوض شده است.
سیستم‌هایی که فقط CSV می‌فهمند
وجود دارند. فایلی ساعت چهار صبح روی سرور SFTP ظاهر می‌شود، یا به‌صورت پیوست می‌رسد، یا در پوشه‌ای مشترک گذاشته می‌شود. یک گردش‌کار می‌تواند مراقبش باشد، بخواندش و هر سطر را یک رکورد بگیرد — حتی فایلی با علامت ترتیب بایت، جداکنندهٔ نقطه‌ویرگول و سطر سرستون به زبان لهستانی، چون خروجی واقعی دقیقاً همین‌شکلی است.
مسیر معکوس هم کار می‌کند: گردش‌کار می‌تواند فایلی بسازد و آن را جایی بگذارد که سیستم دیگر انتظارش را دارد، که اغلب تنها رابطِ یک نرم‌افزار سال ۲۰۰۶ همین است.
- ⚡راه‌اندازفایل جدید روی SFTP تأمین‌کننده:
stock-2026-09-09.csv. - 2تجزیهنقطه‌ویرگول‌ها، علامت ترتیب بایت، سرستون‌های لهستانی. ۴ ۱۱۸ سطر.
- 3استانداردسازیکدهای ارز با داده‌های مرجع بررسی شدند؛ دو مورد به‌عنوان نامعتبر رد شدند.
- 4ارسال
PATCHاز نوع HTTP در دسته‌های ۲۰۰تایی، با رعایت محدودیت نرخ. - !استثناهادو سطر برای یک شخص بایگانی شدند، همراه با شمارهٔ سطر و دلیل. ۴ ۱۱۶ سطر دیگر عبور کردند.
گام‌هایی که مدل را فراخواندند: ۰هزینهٔ این اجرا: هیچ
جای اعتبارنامه‌ها
رمزنگاری‌شده، با نام ارجاع‌شده، محدود به فضای‌کاریِ مالکشان، و هرگز در گزارش اجرا، پیام خطا یا گفتگوی پشتیبانی نمایش داده نمی‌شوند. رکورد اجرا نشان می‌دهد که گامی به‌عنوان supplier-sftp احراز هویت کرده؛ اما نشان نمی‌دهد supplier-sftp چیست.
آژانس‌ای که برای سی مشتری یک گردش‌کار اجرا می‌کند، به هر مشتری مجموعهٔ اعتبارنامهٔ خودش را می‌دهد و گردش‌کار به مجموعه ارجاع می‌دهد نه به رمز. چرخاندن یک کلید فقط یک ویرایش در یک جاست — که دلیل اصلی آمدن آژانس‌ها به اینجاست.
محدودیتی که باید بدانید: سیستمی که هیچ رابطی ندارد — نه API، نه وب‌هوک، نه فایل، هیچ؛ فقط انسانی که در مرورگر کلیک می‌کند — نه با این ابزار و نه با هیچ ابزار درست‌وحسابی دیگری قابل اتوماسیون نیست. اینجا مرورگر بدون سر که خود را کاربر جا بزند وجود ندارد، چون بار اول که طرف مقابل دکمه‌ای را جابه‌جا کند می‌شکند، و بی‌سروصدا می‌شکند.