Istalgan narsani ulash

HTTP kiradi, HTTP chiqadi, noqulay joylar bizda

Har bir avtomatlashtirish vositasi integratsiyalar sonini e’lon qiladi. Bu son har doim katta va har doim noto‘g‘ri savol, chunki sizga haqiqatan kerak bo‘lgan tizim — 2014-yilda ketib qolgan biror kimmay qurgan ichki tizim. Muhimi, vosita ularning barchasi ostidagi protokolni qanchalik yaxshi bilishida.

Tayyor ulanishlar

Ko‘pchilik biznes ishlaydigan ilovalar uchun tayyor qadamlar bor: do‘konlar va marketplace’lar, buxgalteriya va hisob-fakturalar, jadvallar va ma’lumotlar bazalari, taqvimlar va pochta, saqlash va xabarlar, CRM va helpdesk, to‘lov provayderlari va yuk tashuvchilar. Hisobni bir marta avtorizatsiya qilasiz va maydonlar ilova ishlatadigan tilda nomlanadi, uning JSON tili bilan emas.

Ilova Polsha bozoriga xos jihatga ega bo‘lsa — KSeF-ga tayyor bo‘lishi shart bo‘lgan hisob-faktura tizimi, etiketkalari milliy standart bo‘lgan yuk tashuvchi — tayyor qadam buni biladi, chunki oila o‘sha bozorga sotadi va o‘rganishga majbur bo‘lgan.

Va keyin umumiy holat

Qolgan hamma narsa HTTP qadamdir, va bu yerda HTTP qadam tasalli mukofoti emas. Bu tayyor ulanishlar qurilgan o‘sha mexanizmning o‘zi, o‘zingiz yozish zerikarli bo‘lgan qismlarni hal qilish bilan bir xil.

Zerikarli qismlar

Hal qilingan, shuning uchun siz ularni yana yozmaysiz

Autentifikatsiya

API kalitlari, bearer tokenlar, basic auth, refresh bilan OAuth 2, HMAC so‘rov imzosi, o‘zaro TLS. Kredential bir marta saqlanadi, nom bilan murojaat qilinadi va hech qachon logga yoki ish yozuviga chop etilmaydi.

Sahifalash

Kursorlar, sahifa raqamlari, ofsetlar, Link sarlavhalari va bo'sh massiv qaytarish orqali oxirini bildiruvchi API. U qanday shaklda ekanini ayting — qadam butun to'plamni bosib o'tadi.

So'rovlar chegarasi

Har bir ulanish uchun chegara, undan foydalanadigan barcha ish oqimlarida hurmat qilinadi. Provayder Retry-After bilan 429 javob bersa, qadam bosib turib so'rov yuborish o'rniga shuncha kutadi.

Qayta urinishlar va kutish oralig'i

Vaqtinchalik xatolar ortib boruvchi tanaffus va chegaralar bilan qayta urinadi. Qadam kirish ma'lumotlarining sof funksiyasi bo'lgani uchun qayta urinish butun ishni emas, faqat qadamni qayta ishga tushiradi.

Noqulay so'rov tanalari

JSON, forma kodlash, XML, oddiy matn, multipart yuklamalar. Javoblar nomi bilan murojaat qilishingiz mumkin bo'lgan maydonlarga ajratiladi — to'rt qatlam chuqurlikdagi ichki maydonlar ham kiradi.

Vaqt chegaralari

Har bir qadam uchun alohida chegara, shuning uchun bitta sekin tashqi tizim ishchini band qilib, undan keyingi hamma narsani navbatda kutib turmaydi. Chegaradan oshsa nima bo'lishi — har bir qadam uchun sizning qaroringiz.

Agar u HTTP da gaplashsa, suhbat allaqachon boshlangan.

Jiddiy qabul qilinadigan kirish vebxuklari

Har bir ish oqimida uni ishga tushiruvchi URL bo'lishi mumkin. Bu URL imzolarni tekshiradi — keng tarqalgan provayderlar ishlatadigan HMAC shakllarida, va yuboruvchi boshqa hech narsa qila olmasa, umumiy maxfiy kalit bilan. Imzo kutayotgan ish oqimiga imzosiz so'rov rad etiladi va qayd etiladi, jim o'tkazib yuborilmaydi.

Takrorlarni olib tashlash so'rov tanasining o'z identifikatori bo'yicha amalga oshiriladi, shuning uchun sizning 200 javobingizni o'z vaqtida ko'rmay qayta yuborgan yuboruvchi uch emas, bitta ish oladi. Noto'g'ri shakllangan tanalar rad etilgan sababi bilan saqlanadi, chunki avtomatlashtirishdagi tushunarsiz bo'shliqning eng ko'p uchraydigan sababi — yuboruvchining bir maydon haqida fikrini o'zgartirishidir.

Faqat CSV gaplashadigan tizimlar

Ular mavjud. Ertalab soat to'rtta SFTP serverida fayl paydo bo'ladi, yoki ilova sifatida keladi, yoki umumiy papkaga tushadi. Ish oqim uni kuzatishi, o'qishi va har bir qatorni yozuv sifatida ko'rib chiqishi mumkin — bayt tartibi belgisi, nuqta-vergul ajratgichlari va polyakcha sarlavha qatori bo'lgan fayl ham, chunki eksport aslida shunday ko'rinadi.

Teskari yo'nalish ham ishlaydi: ish oqim fayl yig'ib, uni boshqa tizim kutgan joyga qo'yadi — 2006-yilgi dastur uchun ko'pincha bu yagona interfeysdir.

Tungi yetkazib beruvchi lentasiSFTP → HTTP

⚡Ogohlantiruvchi04:02Yetkazib beruvchining SFTP sidagi yangi fayl: stock-2026-09-09.csv.
2Tahlil qilishNuqta-vergullar, bayt tartibi belgisi, polyakcha sarlavhalar. 4 118 qator.
3NormalizatsiyaValyuta kodlari ma'lumotnomaga qarshi tekshirildi; ikkitasi noto'g'ri deb rad etildi.
4Yuborish2.9 sHTTP PATCH 200 tadan iborat partiyalarda, so'rovlar chegarasi hurmat qilingan holda.
!IstisnolarIkki qator odam uchun alohida ajratildi, qator raqami va sababi bilan. Qolgan 4 116 qator o'tib ketdi.

Modelni chaqirgan qadamlar: 0Bu ishning qiymati: hech narsa

Kirish ma'lumotlari qayerda saqlanadi

Shifrlangan, nom bilan murojaat qilinadi, o'z ish maydoniga cheklangan va hech qachon ish jurnaliga, xato xabariga yoki qo'llab-quvvatlash suhbatiga chiqarilmaydi. Ish yozuvi qadam supplier-sftp sifatida autentifikatsiya qilganini ko'rsatadi; supplier-sftp nima ekanini ko'rsatmaydi.

O'ttiz mijoz uchun bitta ish oqim yuritadigan agentlik har bir mijozga o'z kirish ma'lumotlari to'plamini beradi va ish oqim maxfiy kalitga emas, to'plamga murojaat qiladi. Kalitni yangilash bitta joyda bitta tahrir — agentliklar shu yerda bo'lishining asosiy sababi ham shu.

Bilishga arziydigan chegara: umuman interfeysi yo'q tizim — API ham, vebxuk ham, fayl tushirish ham yo'q, faqat odam brauzerda bosadigan — buni na bu, na boshqa halol vosita avtomatlashtira olmaydi. Bu yerda foydalanuvchi qiyofasida bo'lgan brauzersiz brauzer yo'q, chunki u qarshi tomon tugmani surib qo'ysa birinchi marta buziladi va jim buziladi.