Haɗa kome
HTTP shiga, HTTP fita, ɓangarorin wahala an kula da su
Kowane kayan aiki na sarrafa kansa yana tallata adadin haɗin kai. Adadin koyaushe yana da yawa kuma koyaushe tambaya ce ta ƙarya, domin tsarin da kake buƙata a zahiri shi ne na gida aka gina shi a shekarar 2014 ta wanda ya tafi. Abin da ke da muhimmanci shi ne yadda kayan aiki ke iya magana da yarjejeniyar da ke ƙasa da dukkan su.
Haɗin kai na shirye-shirye
Aikace-aikacen da mafi yawan kasuwanci ke amfani da su sun shirya matakai: shaguna da kasuwanni, lissafi da bada takardun biyan kuɗi, takardun lissafi da bayanai, kalanda da wasiƙa, ajiya da saƙonni, CRMs da ɗakunan taimako, masu biyan kuɗi da masu ɗaukar kaya. Ka tabbatar da asusun sau ɗaya kuma filayen ana ba su suna a cikin harshen da aikace-aikacen ke amfani da shi, ba a cikin harshen JSON ɗinsa ba.
Inda aikace-aikacen yana da keɓantaccen al'amari na kasuwar Poland — tsarin bada takardun biyan kuɗi da dole ne ya kasance a shirye don KSeF, mai ɗaukar kaya wanda lakabinsa ƙa'ida ce ta ƙasa — matakin da aka shirya ya san hakan, domin dangin suna sayarwa a wannan kasuwa kuma dole ne su koya.
Sannan babban yanayi
Duk sauran matakin HTTP ne, kuma matakin HTTP a nan ba lada na ta'aziyya ba ne. Shi ne irin na'urar ɗaya da aka gina haɗin kai na shirye-shirye a kai, tare da irin kula da ɓangarorin da gajiya ne a rubuta su da kanka.
Bangarorin gajiya
An kula da su, don kada ka sake rubuta su
Tabbatar da asali
Maɓallan API, alamun mai ɗauke, tabbatarwa ta asali, OAuth 2 tare da sabuntawa, sa hannu kan buƙatun HMAC, TLS na juna. Ana ajiye takardar shaida sau ɗaya, ana kira da suna, kuma ba a taɓa buga shi cikin rajin aiki ko rikodin gudanarwa ba.
Raba shafuka
Cursors, lambobin shafi, offsets, kanun Link, da API ɗin da ke ba da alamar ƙarewa ta hanyar mayar da tsararraki mara komai. Ka faɗi wace siffa take kuma matakin zai yi tafiya ta dukkan saitin.
Iyakokin lokaci
Iyaka ga kowace haɗi, wadda ake girmamawa a kowane aiki da ke amfani da ita. Idan mai bayarwa ya mayar da 429 tare da Retry-After, matakin zai jira har izinin lokacin, ba sake bugawa ba.
Sake gwadawa da jinkirtawa
Kuskuren wucin gadi ana sake gwada su da nesa mai ƙaruwa da iyaka. Mataki aiki ne mai tsabta na abubuwan shigar sa, don haka sake gwadawa yana sake gudanar da matakin, ba sake gudanar da gudanarwar ba.
Abubuwan da ake tuhuma masu wahala
JSON, siffar form, XML, rubutu mai sauki, tuhuma multipart. Amsoshi ana rarraba su zuwa filayen da za ka iya kira da suna, har da waɗanda ke cikin matakan huɗu.
Iyakokin lokaci
Iyaka ga kowane mataki, don haka wata doguwar dogaro ba za ta riƙe mai aiki ba yayin da duk abin da ke bayanta ke jira. Abin da ke faruwa idan an kai ga iyaka shine shawararka, ga kowane mataki.
Idan yana magana da HTTP, tattaunawar ta riga ta fara.
Webhooks masu shigowa, waɗanda ake ɗaukar muhimmanci
Kowane aiki na iya samun URL wanda ke fara shi. Wannan URL yana tabbatar da sa hannu — HMAC a cikin siffofin da manyan masu bayarwa ke amfani da su, da sirrin gama-gari inda haka kawai mai aikawa zai iya. Buƙatar da ba ta da sa hannu zuwa ga aiki da ke tsammanin sa hannu ana ƙi ta kuma ana rubuta ta, ba a sarrafa ta a asirce ba.
Cire kwafin yana kan mai ganowa na tuhumar kanta, don haka mai aikawa wanda ya sake gwadawa saboda bai ga 200 dinka a lokaci yana samun guda ɗaya ba uku. Tuhumar da ba ta da tsari ana riƙe su, tare da dalilin da yasa aka ƙi su, saboda mafi yawan dalilin rata mai ban mamaki a cikin sarrafa kansa mai aikawa ne wanda ya canza ra'ayinsa game da wata filin.
Tsarin da suke magana da CSV kawai
Sun wanzu. Wata fayil tana bayyana a uwar garke ta SFTP da karfe huɗu da dare, ko ta zo a matsayin haɗe-haɗe, ko a jefa ta a cikin babban fayil ɗin raba. Aiki na iya sa ido, karanta ta, da ɗaukar kowane layi a matsayin bayanai — har da fayil ɗin da ke da byte-order mark, masu raba semicolon da layin kanun labarai a harshen Poland, saboda haka ne ainihin siffar fitarwar.
Komawa baya kuma yana aiki: aiki na iya tattara fayil sannan ya saka ta inda sauran tsarin ke tsammanin samun ta, wanda sau da yawa shine kawai hanyar haɗi da software na shekarar 2006 ke da ita.
- ⚡Mai haifarwaSabuwar fayil a SFTP ɗin mai kaya:
stock-2026-09-09.csv. - 2RarrabaSemicolons, byte-order mark, kanun labarai na Poland. Layuka 4 118.
- 3DaidaitaAn duba lambar kuɗi da bayanan tunani; an ƙi biyu a matsayin mara inganci.
- 4TuraHTTP
PATCHa cikin rukunan 200, ana girmama iyakar ƙima. - !KeɓancewaLayuka biyu an yi rajistar su ga mutum ɗaya, tare da lambar layi da dalilin. Sauran 4 116 sun wuce.
Matakan da suka kira samfurin: 0Kudin wannan gudanarwa: babu komai
Inda takaddun shaida ke zaune
An ɓoye su, ana kira da suna, an iyakance su ga sararin aiki wanda ya mallake su, kuma ba a taɓa nuna su a cikin rajistan gudanarwa, saƙon kuskure ko tattaunawar tallafi ba. Rajistan gudanarwa yana nuna cewa mataki ya tabbatar da kansa a matsayin supplier-sftp; ba ya nuna abin da supplier-sftp yake.
Hukuma wadda ke gudanar da aiki ɗaya ga abokan ciniki talatin tana ba da kowane abokin ciniki nasa takaddun shaida, kuma aiki yana koma ga saitin ba ga sirri ba. Canza maɓalli gyara ɗaya ne a wuri ɗaya — wanda shine mafi yawan dalilin da yasa hukumomi suka zo nan.
Iyakar da ya kamata ka sani: tsarin da ba shi da wata hanyar haɗi kwata-kwata — babu API, babu webhook, babu fayil, babu komai sai mutum yana danna a cikin burauza — ba za a iya sarrafa shi da wannan ko da wani abu mai gaskiya ba. Babu burauza marar kai da ke nuna kanta a matsayin mai amfani a nan, saboda hakan ya lalace a lokacin da ɗayan ya motsa maɓalli, kuma yana lalacewa a asirce.