எதையும் இணைத்தல்
HTTP உள்ளே, HTTP வெளியே, கடினமான பகுதிகள் கையாளப்பட்டவை
ஒவ்வொரு தானியங்கு கருவியும் ஒருங்கிணைப்புகளின் எண்ணிக்கையை விளம்பரப்படுத்துகிறது. அந்த எண் எப்போதும் பெரிதாகவும், எப்போதும் தவறான கேள்வியாகவும் இருக்கும்; ஏனெனில் உங்களுக்கு உண்மையில் தேவையான அமைப்பு, வெளியேறிய யாரோ ஒருவர் 2014-இல் உள்நாட்டில் கட்டியது. முக்கியமானது, இவை அனைத்தின் அடியிலுள்ள நெறிமுறையை கருவி எவ்வளவு நன்றாகப் பேசுகிறது என்பதுதான்.
தயாராக உள்ள இணைப்புகள்
பெரும்பாலான வணிகங்கள் நடத்தும் பயன்பாடுகளுக்கு தயாரிக்கப்பட்ட படிகள் உள்ளன: கடைகள் மற்றும் சந்தைகள், கணக்கியல் மற்றும் வில்லைத்தீர்ப்பு, விரிதாள்கள் மற்றும் தரவுத்தளங்கள், நாட்காட்டிகள் மற்றும் அஞ்சல், சேமிப்பு மற்றும் செய்தியாடல், CRM-கள் மற்றும் உதவிமையங்கள், கட்டண வழங்குநர்கள் மற்றும் சரக்கு நிறுவனங்கள். கணக்கை ஒருமுறை அங்கீகரித்தால், புலங்கள் அந்தப் பயன்பாட்டின் மொழியில் பெயரிடப்படும், அதன் JSON-இன் மொழியில் அல்ல.
ஒரு பயன்பாட்டில் போலந்து சந்தைக்கான சிறப்பு அம்சம் இருந்தால் — KSeF-க்குத் தயாராக இருக்க வேண்டிய வில்லைத்தீர்ப்பு அமைப்பு, அதன் லேபிள்கள் தேசிய தரமாக இருக்கும் சரக்கு நிறுவனம் — தயாரிக்கப்பட்ட படி அதை அறியும்; ஏனெனில் குடும்பம் அந்தச் சந்தையில் விற்கிறது, கற்க வேண்டியிருந்தது.
பிறகு பொதுவான நிலை
மீதமுள்ள அனைத்தும் ஒரு HTTP படி; இங்கே HTTP படி என்பது ஆறுதல் பரிசல்ல. தயாரிக்கப்பட்ட இணைப்புகள் கட்டப்பட்ட அதே இயந்திரமே இது; நீங்களே எழுதுவது சலிப்பான பகுதிகளைக் கையாளும் அதே வசதியுடன்.
சலிப்பான பகுதிகள்
கையாளப்பட்டவை, நீங்கள் மீண்டும் எழுத வேண்டியதில்லை
அங்கீகாரம்
API விசைகள், bearer டோக்கன்கள், basic auth, புதுப்பிப்புடன் OAuth 2, HMAC கோரிக்கை கையொப்பம், mutual TLS. ஒரு அறைமுகவர் ஒருமுறை சேமிக்கப்பட்டு, பெயரால் குறிப்பிடப்படும்; பதிவு அல்லது இயக்க பதிவில் ஒருபோதும் அச்சிடப்படாது.
பக்கமாக்கல்
கர்சர்கள், பக்க எண்கள், offsets, Link தலைப்புகள், மற்றும் வெற்று வரிசையைத் திருப்பி முடிவை அறிவிக்கும் API. அது எந்த வடிவம் என்று சொன்னால், படி முழு தொகுப்பையும் நடந்து செல்லும்.
வீத வரம்புகள்
ஒவ்வொரு இணைப்புக்கும் ஒரு வரம்பு, அதைப் பயன்படுத்தும் ஒவ்வொரு பணிப்பாதையிலும் மதிக்கப்படுகிறது. ஒரு வழங்குநர் 429 உடன் Retry-After ஐப் பதிலளித்தால், அடுத்தடுத்துத் தாக்குவதற்குப் பதிலாக அந்தப் படி அந்த நேரம் காத்திருக்கும்.
மீண்டும் முயற்சிகள் மற்றும் பின்வாங்கல்
தற்காலிக தோல்விகள் அதிகரிக்கும் இடைவெளியுடனும் ஒரு வரம்புடனும் மீண்டும் முயற்சிக்கப்படுகின்றன. ஒரு படி அதன் உள்ளீடுகளின் தூய சார்பு என்பதால், மீண்டும் முயற்சி என்பது முழு இயக்கத்தை மீண்டும் இயக்குவதல்லாமல் அந்தப் படியை மட்டும் மீண்டும் இயக்குகிறது.
சிக்கலான தரவுச்சுமைகள்
JSON, படிவக் குறியாக்கம், XML, எளிய உரை, பலபகுதி பதிவேற்றங்கள். பதில்கள் பெயரால் குறிப்பிடக்கூடிய புலங்களாக பாகுபடுத்தப்படுகின்றன — நான்கு நிலைகள் ஆழத்தில் கூடுகளில் இருப்பவை உட்பட.
நேர அளவு வரம்புகள்
ஒரு படிக்கு ஒரு வரம்பு, எனவே ஒரு மெதுவான சார்புத்தொகுதி அதன் பின்னால் உள்ள அனைத்தும் வரிசையில் நிற்கும்போது ஒரு தொழிலாளரைப் பிடித்திருக்க முடியாது. வரம்பு எட்டப்பட்டால் என்ன நடக்கும் என்பது ஒவ்வொரு படிக்கும் உங்கள் முடிவு.
அது HTTP பேசினால், உரையாடல் ஏற்கனவே தொடங்கிவிட்டது.
உள்வரும் வெப்ஹூக்குகள், கவனமாக கையாளப்படுகின்றன
ஒவ்வொரு பணிப்பாதைக்கும் அதைத் தொடங்கும் ஒரு URL இருக்கலாம். அந்த URL கையொப்பங்களைச் சரிபார்க்கிறது — பொதுவான வழங்குநர்கள் பயன்படுத்தும் வடிவங்களில் HMAC, மேலும் அனுப்புநரால் அதுவே அதிகபட்சமாக முடியும் என்றால் ஒரு பகிர்வு ரகசியம். கையொப்பம் எதிர்பார்க்கும் ஒரு பணிப்பாதைக்கு வரும் கையொப்பமிடப்படாத கோரிக்கை மறைமுகமாகச் செயலாக்கப்படாமல் நிராகரிக்கப்பட்டு பதிவு செய்யப்படுகிறது.
நகல் நீக்கம் தரவுச்சுமையின் சொந்த அடையாளத்தின் அடிப்படையில் செய்யப்படுகிறது, எனவே உங்கள் 200 ஐ உடனே பார்க்காததால் மீண்டும் முயற்சிக்கும் ஒரு அனுப்புநர் மூன்று இயக்கங்களுக்குப் பதிலாக ஒரே இயக்கத்தைப் பெறுகிறார். தவறான தரவுச்சுமைகள், அவை ஏன் நிராகரிக்கப்பட்டன என்ற காரணத்துடன் சேமிக்கப்படுகின்றன — ஏனெனில் ஒரு தானியங்கியில் மர்மமான இடைவெளிக்கான மிகப் பொதுவான காரணம், ஒரு புலம் பற்றி மனம் மாறிய அனுப்புநரே ஆவார்.
CSV மட்டுமே பேசும் அமைப்புகள்
அவை உண்மையில் உள்ளன. அதிகாலை நான்கு மணிக்கு ஒரு SFTP சேவையகத்தில் ஒரு கோப்பு தோன்றுகிறது, அல்லது ஒரு இணைப்பாக வருகிறது, அல்லது ஒரு பகிர்வு கோப்புறையில் விடப்படுகிறது. ஒரு பணிப்பாதை அதைக் கண்காணித்து, படித்து, ஒவ்வொரு வரிசையையும் ஒரு பதிவாகக் கருதலாம் — பைட்-ஆர்டர் குறியீடு, அரைப்புள்ளி பிரிப்பான்கள் மற்றும் போலந்து மொழியில் தலைப்பு வரிசை உள்ள கோப்பு உட்பட, ஏனெனில் ஏற்றுமதி உண்மையில் அப்படித்தான் தோற்றமளிக்கிறது.
மறுதிரும்பவும் செய்யலாம்: ஒரு பணிப்பாதை ஒரு கோப்பை உருவாக்கி, மற்ற அமைப்பு எதிர்பார்க்கும் இடத்தில் வைக்கலாம் — 2006 ஆம் ஆண்டு மென்பொருளுக்கு இதுவே பெரும்பாலும் ஒரே இடைமுகம்.
- ⚡தூண்டிவிநியோகஸ்தரின் SFTP இல் புதிய கோப்பு:
stock-2026-09-09.csv. - 2பாகுபடுத்துஅரைப்புள்ளிகள், பைட்-ஆர்டர் குறியீடு, போலந்து தலைப்புகள். 4 118 வரிசைகள்.
- 3இயல்பாக்கம்நாணயக் குறியீடுகள் மேற்கோள் தரவுடன் சரிபார்க்கப்பட்டன; இரண்டு தவறானவை என நிராகரிக்கப்பட்டன.
- 4தள்ளவும்200 இன் தொகுதிகளாக HTTP
PATCH, வேக வரம்பு மதிக்கப்பட்டது. - !விதிவிலக்குகள்ஒரு நபருக்கு இரண்டு வரிசைகள் பதிவு செய்யப்பட்டன, வரிசை எண் மற்றும் காரணத்துடன். மற்ற 4 116 வரிசைகள் சென்றன.
ஒரு மாதிரியை அழைத்த படிகள்: 0இந்த இயக்கத்தின் செலவு: எதுவுமில்லை
அறிவிப்புகள் எங்கு வாழ்கின்றன
மறையாக்கம் செய்யப்பட்டு, பெயரால் குறிப்பிடப்பட்டு, அவற்றை உரிமையாகக் கொண்ட பணியிடத்திற்கு வரம்புக்குட்படுத்தப்பட்டு, ஒரு இயக்கப் பதிவிலோ பிழைச் செய்தியிலோ ஆதரவு உரையாடலிலோ ஒருபோதும் காட்டப்படாதவை. ஒரு இயக்கப் பதிவு ஒரு படி supplier-sftp ஆக அங்கீகரித்தது என்பதைக் காட்டுகிறது; supplier-sftp என்றால் என்ன என்பதை அது காட்டாது.
முப்பது வாடிக்கையாளர்களுக்கு ஒரு பணிப்பாதையை இயக்கும் ஒரு நிறுவனம் ஒவ்வொரு வாடிக்கையாளருக்கும் அதன் சொந்த அறிவிப்புத் தொகுப்பை வழங்குகிறது, மேலும் பணிப்பாதை ரகசியத்தையல்லாமல் தொகுப்பைக் குறிக்கிறது. ஒரு விசையை மாற்றுவது ஒரே இடத்தில் ஒரே திருத்தம் — நிறுவனங்கள் இங்கு வருவதற்கான பெரும்பாலான காரணம் இதுவே ஆகும்.
தெரிந்துகொள்ள வேண்டிய வரம்பு: எந்த இடைமுகமும் இல்லாத ஒரு அமைப்பு — API இல்லை, வெப்ஹூக் இல்லை, கோப்பு வரவு இல்லை, உலாவியில் சொடுக்கும் ஒரு நபரைத் தவிர எதுவும் இல்லை — அதை இதனாலோ வேறு எந்த நேர்மையான கருவியாலோ தானியங்குபடுத்த முடியாது. இங்கு ஒரு பயனராக நடிக்கும் தலையில்லா உலாவி இல்லை, ஏனெனில் அது மறுமுனை ஒரு பொத்தானை நகர்த்தும்போது முதல் முறையே உடைந்து, மறைமுகமாகவே உடைகிறது.