Nəsə qoşmaq

HTTP girir, HTTP çıxır, çətin hissələr həll edilir

Hər avtomatlaşdırma aləti inteqrasiya sayı reklam edir. Say həmişə böyükdür və həmişə yanlış sualdır, çünki sizə lazım olan sistem 2014-cü ildə getmiş birisi tərəfindən daxili yazılmışdır. Önəmli olan, alətin hamısının altında duran protokolu nə qədər yaxşı danışmasıdır.

Hazır bağlantılar

Bizneslərin işlədiyi əsas tətbiqlər üçün hazırlanmış addımlar var: mağazalar və marketpleyslər, mühasibatlıq və fakturalaşdırma, cədvəllər və bazalar, təqvimlər və poçt, saxlama və mesajlaşma, CRM-lər və helpdesklər, ödəniş provayderləri və daşıyıcılar. Hesabı bir dəfə səlahiyyətləndirirsiniz və sahələr tətbiqin JSON dilində deyil, tətbiqin öz dilində adlanır.

Tətbiqdə Polşa bazarına xas xüsusiyyət varsa — KSeF-ə hazır olmalı olan fakturalaşdırma sistemi, etiketləri milli standart olan daşıyıcı — hazır addım bunu bilir, çünki ailə həmin bazarına satır və öyrənməli olub.

Sonra isə ümumi hal

Qalan hər şey HTTP addımıdır və buradakı HTTP addımı təsəlli mükafatı deyil. Bu, hazır bağlantıların qurulduğu eyni maşındır, özünüz yazmaq yorucu olan hissələrin eyni idarəsi ilə.

Yorucu hissələr

Həll edilir, ki siz onları yenidən yazmayasınız

Autentifikasiya

API açarları, bearer tokenlər, basic auth, yeniləmə ilə OAuth 2, HMAC sorğu imzalaması, qarşılıqlı TLS. Sələfiyyət bir dəfə saxlanılır, adla istinad edilir və heç vaxt jurnala və ya icra qeydinə çap edilmir.

Səhifələmə

Kursorlar, səhifə nömrələri, ofsetlər, Link başlıqları və sonu boş massiv qaytarmaqla bildirən API. Hansı formada olduğunu deyin və addım bütün dəsti gəzir.

Sorğu limitləri

Hər bağlantı üçün tavan, ondan istifadə edən bütün iş axınlarında nəzərə alınır. Provayder 429 cavabını Retry-After ilə verdiyində, addım gözləyir, dəfələrlə müraciət etmir.

Təkrar cəhdlər və gözləmə artımı

Müvəqqəti uğursuzluqlar artan fasilə və tavanla yenidən cəhd edilir. Addım girişlərinin saf funksiyası olduğundan, təkrar cəhd bütün icranı deyil, yalnız addımı yenidən işə salır.

Çətin yük formatları

JSON, forma kodlaşdırması, XML, adi mətn, multipart yükləmələri. Cavablar adla istinad edə biləcəyiniz sahələrə ayrılır — dörd səviyyə dərinlikdəki daxili sahələr də daxil olmaqla.

Vaxt limitləri

Hər addım üçün limit, beləliklə yavaş bir asılılıq işçini tutub arxadakı hər şeyi növbəyə sala bilmir. Limit aşılarkən nə baş verəcəyi hər addım üçün sizin qərarınızdır.

HTTP danışırsa, söhbət artıq başlayıb.

Gələn vebhuklara ciddi yanaşma

Hər iş axınının onu başladan URL-i ola bilər. Bu URL imzaları yoxlayır — ümumi provayderlərin istifadə etdiyi formada HMAC, göndərəcin daha çoxuna gücü çatmadıqda isə paylaşılan gizli açar. İmza gözləyən iş axınına imzasız sorğu rədd edilir və qeydə alınır, sükutla icra edilmir.

Təkrarların aradan qaldırılması yükün öz identifikatoruna əsaslanır, ona görə 200 cavabınızı vaxtında görmədiyi üçün yenidən cəhd edən göndərəc üç deyil, bir icra alır. Səhv formatlı yüklər rədd edilmə səbəbi ilə birlikdə saxlanılır, çünki avtomatlaşdırmada sirli boşluqların ən çox səbəbi bir sahə barədə fikrini dəyişən göndərəcdir.

Yalnız CSV danışan sistemlər

Onlar mövcuddur. Səhər saat dördündə SFTP serverində fayl peyda olur, ya da əlavə kimi gəlir, ya da paylaşılan qovluğa atılır. İş axını onu izləyə, oxuya və hər sətri qeyd kimi qəbul edə bilər — bayt sıralama işarəsi, nöqtəli vergül ayırıcıları və polyak dilində başlıq sətri olan fayl da daxil olmaqla, çünki eksport əslində belə görünür.

Əks istiqamətdə də işləyir: iş axını fayl yığa və digər sistemin onu gözlədiyi yerə qoya bilər — 2006-cı il proqramının çox vaxt yeganə interfeysi budur.

Gecəlik təchizatçı axınıSFTP → HTTP

⚡Tətikləyici04:02Təchizatçının SFTP-sində yeni fayl: stock-2026-09-09.csv.
2TəhlilNöqtəli vergüllər, bayt sıralama işarəsi, polyak başlıqlar. 4 118 sətir.
3NormallaşdırmaValyuta kodları istinad məlumatları ilə yoxlanıldı; ikisi etibarsız sayılaraq rədd edildi.
4Göndər2.9 sHTTP PATCH 200-lük partiyalarla, sorğu limitinə riayət edilir.
!İstisnalarİki sətir bir şəxs üçün ayrıldı — sətir nömrəsi və səbəbi ilə. Qalan 4 116 sətir keçdi.

Model çağıran addımlar: 0Bu icranın maya dəyəri: sıfır

Kimlik məlumatları harada saxlanır

Şifrələnir, adla istinad edilir, sahibi olan iş sahəsinə məhdudlaşdırılır və heç vaxt icra jurnalına, xəta mesajına və ya dəstək söhbətinə əks olunmur. İcra qeydi addımın supplier-sftp kimi təsdiqləndiyini göstərir; supplier-sftp-nin nə olduğunu göstərmir.

Otuz müştəri üçün bir iş axını işlədən agentlik hər müştəriyə öz kimlik dəstinə verir və iş axını sirrə deyil, dəstə istinad edir. Açarı dəyişmək bir yerdə bir redaktədir — agentliklərin bura gəlməsinin əsas səbəbi də məhz budur.

Bilməyə dəyər olan limit: heç bir interfeysi olmayan sistem — ne API, ne vebhuk, ne fayl qəbulu, yalnız brauzerdə klikləyən insan — bununla da, dürüst heç nə ilə də avtomatlaşdırıla bilməz. Burada istifadəçi rolunu oynayan başsız brauzer yoxdur, çünki o, qarşı tərəf düyməni yerindən çəkən kimi sükutla sınır.