ඊමේල් ඇට්ච්මෙන්ට් එකක් API එකක් හරහා යැවීමට උත්සාහ කරන ඩෙවලපර්ලාට, "එය සරළයි" කියලා හැමෝම හිතනවා. නමුත් ප්රථම සීමාවකට මුහුණ දෙන්නෙත්, Base64‑එන්කෝඩ් කරන PDF එකක් 4 MB පමණයි කියලා JSON ඇතුළත් කිරීමේදී අසාර්ථක වෙන්නේ, ඒක මුලු ඉල්ලීමේ ප්රමාණ සීමාව නිසාය.
Nylas විසින් දෙකම ක්රම දෙකක් සපයනවා: JSON schema (Base64) සහ multipart/form‑data schema. JSON ක්රමය සරල POST /messages/send ඉල්ලීමකට attachments array එකක් එක් කරනවා, ඒක 3 MB පමණ මුලු payload සීමාවක් ගනී. එයට වඩා විශාල ගොනු (25 MB දක්වා) multipart ක්රමය භාවිතා කරයි, ගොනුව බිනරි ලෙස යොමු කරයි.
මෙහි වැදගත් කරුණක් 3 MB සීමාව මුලු HTTP ඉල්ලීමේ ප්රමාණයටය. ඔබේ HTML බොඩි, ශීර්ෂක, ලැබුම්කරුවන්, තවත් ඇට්ච්මෙන්ට් සියල්ල එකට ගනී. Base64 එන්කෝඩ් කිරීම ගොනුවේ ප්රමාණය සுமார் 33% කින් වැඩි කරයි; 2.2 MB ගොනුවක් 3 MB කට ආසන්නයි. ඒ නිසා, JSON ක්රමය 2 MB පමණ ගොනු වලට පමණක් භාවිතා කරනවා, 3 MB ට අඩු ගොනු වලටත් බොඩි දිගු නම් multipart වෙත මාරු වන්න.
JSON ක්රමය භාවිතා කරන විට, ඔබට attachments අරේ එකක් දාන්න පුළුවන්, ඒ අරේ තුළ filename, content_type, content (Base64) වැනි ගුණයන් තිබේ. එකම ඉල්ලීමේදී බොහෝ ගොනු එක්කල හැකි නමුත් මුලු payload 3 MB ඉක්මවා නොයැවිය යුතුය.
25 MB දක්වා ගොනු යැවීමට අවශ්ය නම් multipart/form‑data භාවිතා කරන්න. මෙහිදී ගොනුව බිනරි ලෙස එක් කරයි, එමනිසා Base64 එන්කෝඩ් කිරීමේ අතිරේකය නැත. Nylas CLI භාවිතා කරලා ලැබූ පණිවුඩයේ ඇට්ච්මෙන්ට් බාගත කිරීමේදී, පණිවුඩ ID එකත් එක්ක attachment ID එකත් ලබා දීමට අවශ්ය බව මතක තබා ගන්න.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තාක්ෂණික පුරෝගාමීත්වය ඉක්මවා යාමට, Nylas API එකේ මේ සීමා සහ උපදෙස් වැදගත් වේ. සිසුන්, ස්ථාපිත ව්යාපාරිකයින්, ස්ටාට්අප්ස් ආදියට:
- ඊමේල් ස්වයංක්රිය කිරීමේ කාලය කෙටි කර, කාර්ය සාධනය වැඩි කරයි.
- Base64 සීමාව හඳුනාගෙන, ගොනු ප්රමාණය අනුව JSON හෝ multipart තේරීමෙන් අඩු වැය සහිතව වැඩ කරයි.
- CLI භාවිතයෙන් ලැබූ ඇට්ච්මෙන්ට් ඉක්මනින් බාගත කර, දත්ත විශ්ලේෂණය හෝ පාරිභෝගික සේවා වැඩිදියුණු කරගත හැක.
- වෙනත් cloud සේවා (AWS, Azure) සමඟ පහසුවෙන් ඒකාබද්ධ කර, දේශීය ව්යාපාරික පද්ධතිවලට අන්තර්ජාල තත්ත්වය අඩංගුවේ ඉදිරිපත් කරයි.
අවසන් වශයෙන්, Nylas API එකේ ඇට්ච්මෙන්ට් සීමා සහ CLI උපකරණ හොඳින් අවබෝධ කරගතහොත්, ඔබේ ඊමේල් වැඩසටහන් තවත් පිරිසිදු, වේගවත්, හා ආරක්ෂිතව ක්රියාත්මක කරගත හැකිය. අදම මෙම උපදෙස් පරික්ෂා කර, ඔබේ ව්යාපාරයට හෝ පුද්ගලික වැඩකටයුතු සඳහා නව ප්රයෝජන ගෙන එන්න.
