API ການແປພາສາເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ: ໄວ ແລະ ຖືກຕ້ອງ

ຄວາມສັບສົນຂອງການແປພາສາເອກະສານແບບຕາຕະລາງ

ນັກພັດທະນາມັກຈະພົບກັບສິ່ງທ້າທາຍທີ່ສຳຄັນເມື່ອສ້າງການເຊື່ອມໂຍງ API ການແປພາສາເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ. ອຸປະສັກເຫຼົ່ານີ້ຂະຫຍາຍອອກໄປໄກກວ່າການປ່ຽນແທນສະຕຣິງແບບງ່າຍໆ.
ຂະບວນການດັ່ງກ່າວລວມມີການຈັດການໄຟລ໌ແບບເລິກເຊິ່ງ, ຄວາມເຂົ້າໃຈດ້ານພາສາສາດ, ແລະການຄຸ້ມຄອງການເຂົ້າລະຫັດທີ່ຊັບຊ້ອນ ເຊິ່ງສາມາດກາຍເປັນຂໍ້ຈຳກັດດ້ານວິສະວະກຳທີ່ສຳຄັນໄດ້ຢ່າງວ່ອງໄວ.

ການແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາເກົາຫຼີໃຫ້ສຳເລັດຮຽບຮ້ອຍຮຽກຮ້ອງໃຫ້ມີວິທີການທີ່ຊັບຊ້ອນ. ທ່ານຕ້ອງຮັກສາຮູບແບບ ແລະ ການຈັດວາງທີ່ລະອຽດຂອງໄຟລ໌ຕົ້ນສະບັບ.
ອັນນີ້ລວມມີອົງປະກອບຕ່າງໆ ເຊັ່ນ: ຕາຕະລາງ, ເຄື່ອງໝາຍຫົວ (headers), ເຄື່ອງໝາຍທ້າຍ (footers), ແລະ ການຈັດວາງຮູບພາບ, ເຊິ່ງມັກຈະສູນເສຍໄປດ້ວຍວິທີການແປແບບງ່າຍໆ. ການຮັກສາຄວາມຄົງຕົວທາງດ້ານໂຄງສ້າງນີ້ແມ່ນສຳຄັນສຳລັບຜົນຜະລິດທີ່ເປັນມືອາຊີບ ແລະ ນຳໃຊ້ໄດ້.

ສິ່ງທ້າທາຍໃນການເຂົ້າລະຫັດຕົວອັກສອນ (Character Encoding)

ບັນຫາໜຶ່ງທີ່ເກີດຂຶ້ນທັນທີທັນໃດແມ່ນການເຂົ້າລະຫັດຕົວອັກສອນ, ເຊິ່ງເປັນປັດໄຈສຳຄັນເມື່ອຈັດການກັບຕົວໜັງສື Hangul ພາສາເກົາຫຼີ. ພາສາອັງກິດປົກກະຕິແລ້ວໃຊ້ໂຄງການເຂົ້າລະຫັດແບບງ່າຍດາຍ, ແຕ່ພາສາເກົາຫຼີຮຽກຮ້ອງໃຫ້ມີມາດຕະຖານທີ່ສັບສົນກວ່າ ເຊັ່ນ: UTF-8 ຫຼື EUC-KR ລຸ້ນເກົ່າ.
ຄວາມບໍ່ກົງກັນໃນການເຂົ້າລະຫັດໃນລະຫວ່າງການປະມວນຜົນໄຟລ໌ສາມາດນໍາໄປສູ່ “mojibake,” ເຊິ່ງຕົວອັກສອນຖືກສະແດງເປັນສັນຍາລັກທີ່ຖືກບິດເບືອນ ຫຼື ບໍ່ມີຄວາມໝາຍ. ອັນນີ້ເຮັດໃຫ້ເອກະສານສຸດທ້າຍບໍ່ສາມາດອ່ານໄດ້ຢ່າງສິ້ນເຊີງ ແລະ ບໍ່ເປັນມືອາຊີບ.

ການຈັດການການເຂົ້າລະຫັດເຫຼົ່ານີ້ຢ່າງຖືກຕ້ອງພາຍໃນໂຄງສ້າງຖານສອງ (binary structure) ຂອງເອກະສານບໍ່ແມ່ນວຽກທີ່ງ່າຍດາຍ. ມັນຮຽກຮ້ອງໃຫ້ຊອບແວອ່ານ, ຕີຄວາມໝາຍ, ແປ, ແລະ ຫຼັງຈາກນັ້ນຂຽນໄຟລ໌ຄືນໃໝ່ ໃນຂະນະທີ່ເຄົາລົບຕາມລຳດັບໄບຕ໌ສະເພາະ ແລະ ກົດລະບຽບການເຂົ້າລະຫັດ.
ຫາກບໍ່ມີເຄື່ອງຈັກພິເສດ, ນັກພັດທະນາຈະຕ້ອງສ້າງຕົວແຍກວິເຄາະ (parsers) ແບບກຳນົດເອງສຳລັບປະເພດໄຟລ໌ແຕ່ລະອັນ, ເຊັ່ນ: DOCX, PDF, ຫຼື PPTX. ອັນນີ້ແມ່ນວຽກທີ່ໃຊ້ເວລາຫຼາຍ ແລະ ມີແນວໂນ້ມທີ່ຈະເກີດຂໍ້ຜິດພາດ.

ການຮັກສາການຈັດວາງ ແລະ ຮູບແບບທີ່ຊັບຊ້ອນ

ເອກະສານສະໄໝໃໝ່ແມ່ນອຸດົມສົມບູນທາງດ້ານສາຍຕາ ແລະ ສັບສົນທາງດ້ານໂຄງສ້າງ, ເຊິ່ງເປັນຄຸນສົມບັດທີ່ API ການແປຂໍ້ຄວາມມາດຕະຖານບໍ່ສົນໃຈ. API ການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ ຕ້ອງເຮັດຫຼາຍກວ່າການພຽງແຕ່ປ່ຽນຄຳສັບ.
ມັນຈຳເປັນຕ້ອງເຂົ້າໃຈຄວາມສຳພັນທາງດ້ານພື້ນທີ່ລະຫວ່າງຂໍ້ຄວາມ, ຮູບພາບ, ຖັນ, ແລະ ຕາຕະລາງ. ຄວາມລົ້ມເຫຼວໃນການເຮັດແນວນັ້ນສົ່ງຜົນໃຫ້ເກີດເອກະສານທີ່ເປັນຄວາມວຸ້ນວາຍຂອງຂໍ້ຄວາມ, ສູນເສຍສະພາບການຕົ້ນສະບັບ ແລະ ຄວາມສາມາດໃນການອ່ານທັງໝົດ.

ພິຈາລະນາຂໍ້ສະເໜີທາງທຸລະກິດໃນໄຟລ໌ DOCX ທີ່ມີການຈັດວາງຫຼາຍຖັນ, ຕາຕະລາງຝັງຕົວ, ແລະ ຕົວອັກສອນຍີ່ຫໍ້ສະເພາະ. ການສະກັດຂໍ້ຄວາມແບບງ່າຍໆຈະເອົາສະພາບການທັງໝົດນີ້ອອກໄປ.
ຂໍ້ຄວາມພາສາເກົາຫຼີທີ່ຖືກແປແລ້ວ, ເຊິ່ງມັກຈະມີຄວາມຍາວປະໂຫຍກ ແລະ ຄວາມກວ້າງຂອງຕົວອັກສອນທີ່ແຕກຕ່າງກັນ, ຈະຕ້ອງຖືກຈັດລຽງໃໝ່ຢ່າງສະຫຼາດເຂົ້າໃນການອອກແບບຕົ້ນສະບັບ. ອັນນີ້ຮຽກຮ້ອງໃຫ້ມີເຄື່ອງຈັກການແປທີ່ຮູ້ຈັກການຈັດວາງ ເພື່ອປ້ອງກັນບໍ່ໃຫ້ຂໍ້ຄວາມລົ້ນ, ຕາຕະລາງແຕກ, ແລະ ຮູບພາບຈັດວາງບໍ່ຖືກຕ້ອງ.

ການຮັກສາຄວາມຄົງຕົວຂອງໂຄງສ້າງໄຟລ໌

ນອກເໜືອໄປຈາກການຈັດວາງແບບສາຍຕາ, ໂຄງສ້າງພາຍໃນຂອງໄຟລ໌ເຊັ່ນ DOCX ຫຼື PPTX ແມ່ນສັບສົນຢ່າງບໍ່ໜ້າເຊື່ອ. ໂດຍພື້ນຖານແລ້ວ, ສິ່ງເຫຼົ່ານີ້ແມ່ນບ່ອນເກັບຂໍ້ມູນແບບ zipped ຂອງໄຟລ໌ XML, ສິ່ງຊັບສິນສື່, ແລະ ຂໍ້ມູນການພົວພັນທີ່ກໍານົດເອກະສານ.
ການປ່ຽນເນື້ອໃນຂໍ້ຄວາມແບບຕາຕະລາງພາຍໃນໄຟລ໌ XML ເຫຼົ່ານີ້ ໂດຍບໍ່ເຮັດໃຫ້ບ່ອນເກັບຂໍ້ມູນເສຍຫາຍແມ່ນຄວາມສ່ຽງທີ່ສໍາຄັນ. ຄວາມຜິດພາດດຽວສາມາດເຮັດໃຫ້ເອກະສານທັງໝົດບໍ່ສາມາດນຳໃຊ້ໄດ້ ແລະ ບໍ່ສາມາດເປີດໄດ້ໂດຍຊອບແວມາດຕະຖານ ເຊັ່ນ: Microsoft Word ຫຼື Adobe Reader.

ນີ້ແມ່ນເຫດຜົນທີ່ວ່າ API ການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ ທີ່ເຂັ້ມແຂງຈຶ່ງມີຄວາມຈຳເປັນຫຼາຍ. ມັນຊ່ອງທາງປ້ອງກັນອັນຕະລາຍຂອງການເສຍຫາຍຂອງໄຟລ໌ໂດຍການຈັດການຂະບວນການແຍກວິເຄາະ ແລະ ການກໍ່ສ້າງຄືນໃໝ່ຢ່າງປອດໄພ.
ນັກພັດທະນາສາມາດສົ່ງໄຟລ໌ແຫຼ່ງຂໍ້ມູນ ແລະ ໄດ້ຮັບສະບັບທີ່ຖືກແປແລ້ວທີ່ມີໂຄງສ້າງທີ່ສົມບູນແບບກັບຄືນມາ. ອັນນີ້ເຮັດໃຫ້ພາລະໃນການກາຍເປັນຜູ້ຊ່ຽວຊານໃນສະເພາະດ້ານທີ່ຊັບຊ້ອນຂອງຮູບແບບເອກະສານທີ່ເປັນໄປໄດ້ທັງໝົດ.

ການນໍາສະເໜີ Doctranslate API ສໍາລັບການແປພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ

The Doctranslate API ສະໜອງການແກ້ໄຂບັນຫາທີ່ຊົງພະລັງ ແລະ ມີຄວາມຄ່ອງຕົວຕໍ່ສິ່ງທ້າທາຍເຫຼົ່ານີ້ທັງໝົດ. ມັນເປັນບໍລິການ RESTful ທີ່ຖືກອອກແບບມາສະເພາະສຳລັບການແປເອກະສານທີ່ມີຄວາມຖືກຕ້ອງສູງ, ຮັບປະກັນວ່າໂຄງການ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ ຂອງທ່ານຈະປະສົບຜົນສຳເລັດ.
API ຂອງພວກເຮົາຈັດການກັບຄວາມສັບສົນຂອງການແຍກວິເຄາະໄຟລ໌, ການຮັກສາການຈັດວາງ, ແລະ ການເຂົ້າລະຫັດຕົວອັກສອນໂດຍອັດຕະໂນມັດ. ອັນນີ້ຊ່ວຍໃຫ້ທ່ານສາມາດສຸມໃສ່ເຫດຜົນຫຼັກຂອງແອັບພລິເຄຊັນຂອງທ່ານ ແທນທີ່ຈະເປັນການຈັດການໄຟລ໌ລະດັບຕໍ່າ.

ໂດຍການນໍາໃຊ້ບໍລິການຂອງພວກເຮົາ, ທ່ານສາມາດແປຮູບແບບເອກະສານທີ່ຫຼາກຫຼາຍດ້ວຍ API ດຽວ, ແບບລວມກັນ. ພວກເຮົາສະເໜີ ຄວາມຖືກຕ້ອງທີ່ບໍ່ມີໃຜທຽບເທົ່າ ໃນການແປ ແລະ ການຮັກສາການຈັດວາງທີ່ດີກວ່າ ໃນທຸກປະເພດໄຟລ໌ທີ່ຮອງຮັບ.
ອັນນີ້ຮັບປະກັນວ່າເອກະສານພາສາເກົາຫຼີສຸດທ້າຍຈະຄືກັນກັບແຫຼ່ງຂໍ້ມູນພາສາອັງກິດຕົ້ນສະບັບທັງໃນດ້ານເນື້ອຫາ ແລະ ການອອກແບບ. ສຳລັບນັກພັດທະນາທີ່ຊອກຫາການເພີ່ມຄຸນສົມບັດການແປພາສາທີ່ມີປະສິດທິພາບ, ສຳຫຼວດວິທີ ສ້າງປະສົບການຫຼາຍພາສາທີ່ໂດດເດັ່ນດ້ວຍ API ການແປເອກະສານຂອງພວກເຮົາ ໃນມື້ນີ້.

ການແກ້ໄຂບັນຫາ RESTful ທີ່ເນັ້ນໃສ່ນັກພັດທະນາເປັນອັນດັບທຳອິດ

API ຂອງພວກເຮົາຖືກສ້າງຂຶ້ນບົນຫຼັກການ REST ມາດຕະຖານ, ເຮັດໃຫ້ມັນງ່າຍຕໍ່ການເຊື່ອມໂຍງເຂົ້າໃນເຕັກໂນໂລຢີສະແຕັກທີ່ທັນສະໄໝໃດກໍໄດ້. ມັນໃຊ້ URLs ທີ່ຄາດເດົາໄດ້, ເນັ້ນໃສ່ຊັບພະຍາກອນ ແລະ ສົ່ງຄືນການຕອບສະໜອງ JSON ມາດຕະຖານສຳລັບການອັບເດດສະຖານະ ແລະ ເມຕາເດຕາ.
ການກວດສອບຄວາມຖືກຕ້ອງແມ່ນຈັດການຜ່ານລະຫັດ API ງ່າຍໆທີ່ສົ່ງຜ່ານໃນສ່ວນຫົວຂອງຄຳຮ້ອງຂໍ. ຂະບວນການເຮັດວຽກທັງໝົດຖືກອອກແບບມາໃຫ້ເຂົ້າໃຈງ່າຍສຳລັບນັກພັດທະນາ, ຫຼຸດຜ່ອນຄວາມຫຍຸ້ງຍາກໃນການຮຽນຮູ້ ແລະ ເລັ່ງເວລາການພັດທະນາ.

ລັກສະນະແບບ asynchronous (ບໍ່ພ້ອມກັນ) ຂອງ API ແມ່ນເໝາະສຳລັບການຈັດການເອກະສານຂະໜາດໃຫຍ່ ຫຼື ຊັບຊ້ອນໂດຍບໍ່ມີການບລັອກແອັບພລິເຄຊັນຂອງທ່ານ. ທ່ານສາມາດສົ່ງຄຳຮ້ອງຂໍການແປ ແລະ ໄດ້ຮັບ document ID ທັນທີ.
ຈາກນັ້ນ, ທ່ານສາມາດສອບຖາມຈຸດປາຍທາງສະຖານະເປັນໄລຍະ ເພື່ອກວດເບິ່ງຄວາມຄືບໜ້າ. ຮູບແບບທີ່ບໍ່ມີການບລັອກນີ້ແມ່ນສາມາດຂະຫຍາຍໄດ້ສູງ ແລະ ມີປະສິດທິພາບສຳລັບແອັບພລິເຄຊັນໃດກໍໄດ້.

ຄຸນສົມບັດຫຼັກ ແລະ ຜົນປະໂຫຍດ

The Doctranslate API ສະໜອງຊຸດຄຸນສົມບັດທີ່ສົມບູນແບບທີ່ຖືກປັບແຕ່ງສຳລັບກໍລະນີການນໍາໃຊ້ແບບມືອາຊີບ. ພວກເຮົາໃຫ້ການ ຮອງຮັບຮູບແບບໄຟລ໌ຫຼາຍສິບຊະນິດ, ລວມທັງ PDF, DOCX, PPTX, XLSX, ແລະ ອື່ນໆ.
ຄວາມຫລາກຫລາຍນີ້ຫມາຍຄວາມວ່າທ່ານບໍ່ຈໍາເປັນຕ້ອງສ້າງຂະບວນການແຍກຕ່າງຫາກສໍາລັບປະເພດເອກະສານທີ່ແຕກຕ່າງກັນ. ເຄື່ອງຈັກຂອງພວກເຮົາຈັດການພວກມັນທັງໝົດໄດ້ຢ່າງລຽບງ່າຍຜ່ານຈຸດເຊື່ອມໂຍງອັນດຽວ.

ຍິ່ງໄປກວ່ານັ້ນ, ບໍລິການຂອງພວກເຮົາໄດ້ຖືກປັບປຸງໃຫ້ເໝາະສົມສຳລັບທັງຄວາມໄວ ແລະ ຄຸນນະພາບ. ພວກເຮົາໃຊ້ແບບຈຳລອງການແປຂັ້ນສູງເພື່ອຮັບປະກັນຄວາມຖືກຕ້ອງທາງດ້ານພາສາສາດ ໃນຂະນະທີ່ເຄື່ອງຈັກການຈັດວາງຂອງພວກເຮົາເຮັດວຽກເພື່ອຮັກສາຮູບຮ່າງໜ້າຕາຂອງເອກະສານຕົ້ນສະບັບ.
ຜົນປະໂຫຍດເພີ່ມເຕີມລວມມີ ການຈັດການໄຟລ໌ທີ່ປອດໄພ ດ້ວຍການເຂົ້າລະຫັດແບບຕົ້ນທາງຫາປາຍທາງ ແລະ ຄວາມສາມາດໃນການປະຕິບັດ ການແປເປັນຊຸດ ສໍາລັບໂຄງການຂະໜາດໃຫຍ່. ຄຸນສົມບັດເຫຼົ່ານີ້ເຮັດໃຫ້ມັນເປັນທາງເລືອກທີ່ເໝາະສົມສຳລັບແອັບພລິເຄຊັນລະດັບວິສາຫະກິດ.

ຄູ່ມືຂັ້ນຕອນຕໍ່ຂັ້ນຕອນໃນການເຊື່ອມໂຍງ API

ການເຊື່ອມໂຍງ API ການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ ເຂົ້າໃນແອັບພລິເຄຊັນຂອງທ່ານແມ່ນຂະບວນການທີ່ງ່າຍດາຍ. ຄູ່ມືນີ້ຈະນໍາພາທ່ານຜ່ານຂັ້ນຕອນທີ່ຈຳເປັນ, ຕັ້ງແຕ່ການກວດສອບຄວາມຖືກຕ້ອງຈົນເຖິງການດາວໂຫຼດໄຟລ໌ທີ່ຖືກແປແລ້ວຂອງທ່ານ.
ພວກເຮົາຈະໃຊ້ Python ໃນຕົວຢ່າງຂອງພວກເຮົາ, ແຕ່ຫຼັກການຕ່າງໆແມ່ນນໍາໃຊ້ກັບພາສາການຂຽນໂປຣແກຣມໃດກໍໄດ້ທີ່ສາມາດສ້າງຄໍາຮ້ອງຂໍ HTTP ໄດ້. ຂະບວນການທັງໝົດສາມາດແບ່ງອອກເປັນສີ່ຂັ້ນຕອນງ່າຍໆ.

ເງື່ອນໄຂເບື້ອງຕົ້ນ: ການໄດ້ຮັບ API Key ຂອງທ່ານ

ກ່ອນທີ່ທ່ານຈະສາມາດສ້າງການເອີ້ນໃຊ້ API ໃດໆກໍຕາມ, ທ່ານຈໍາເປັນຕ້ອງໄດ້ຮັບ API key. ລະຫັດນີ້ຖືກໃຊ້ເພື່ອກວດສອບຄວາມຖືກຕ້ອງຂອງຄຳຮ້ອງຂໍຂອງທ່ານ ແລະ ເຊື່ອມໂຍງພວກມັນເຂົ້າກັບບັນຊີຂອງທ່ານ.
ກ່ອນອື່ນ, ທ່ານຕ້ອງລົງທະບຽນສໍາລັບບັນຊີນັກພັດທະນາ Doctranslate developer account ຢູ່ແພລດຟອມຂອງພວກເຮົາ. ຫຼັງຈາກການລົງທະບຽນ ແລະ ການຢັ້ງຢືນ, ທ່ານສາມາດໄປທີ່ສ່ວນການຕັ້ງຄ່າ API ຂອງ dashboard ຂອງທ່ານເພື່ອສ້າງລະຫັດສະເພາະຂອງທ່ານ.

ມັນເປັນສິ່ງສໍາຄັນທີ່ຈະຮັກສາ API key ຂອງທ່ານໃຫ້ປອດໄພ ແລະ ເປັນຄວາມລັບ. ທ່ານບໍ່ຄວນເປີດເຜີຍມັນຢູ່ໃນລະຫັດຝ່າຍລູກຄ້າ (client-side code) ຫຼື ມອບມັນໃຫ້ກັບບ່ອນເກັບຂໍ້ມູນຄວບຄຸມເວີຊັນສາທາລະນະ.
ພວກເຮົາແນະນຳໃຫ້ເກັບຮັກສາມັນເປັນຕົວແປສະພາບແວດລ້ອມ (environment variable) ຫຼື ໃຊ້ບໍລິການຄຸ້ມຄອງຄວາມລັບ. ການປະຕິບັດນີ້ຮັບປະກັນວ່າບັນຊີຂອງທ່ານຍັງຄົງປອດໄພ ໃນຂະນະທີ່ອະນຸຍາດໃຫ້ແອັບພລິເຄຊັນຂອງທ່ານເຂົ້າເຖິງມັນໄດ້ເມື່ອຈຳເປັນ.

ຂັ້ນຕອນທີ 1: ການກວດສອບຄວາມຖືກຕ້ອງຂອງຄຳຮ້ອງຂໍຂອງທ່ານ

ຄໍາຮ້ອງຂໍທັງໝົດຕໍ່ Doctranslate API ຕ້ອງຖືກກວດສອບຄວາມຖືກຕ້ອງໂດຍໃຊ້ API key ຂອງທ່ານ. ອັນນີ້ແມ່ນເຮັດໄດ້ໂດຍການລວມເອົາສ່ວນຫົວ Authorization ໃນຄໍາຮ້ອງຂໍ HTTP ຂອງທ່ານ.
ສ່ວນຫົວຄວນໃຊ້ໂຄງການກວດສອບຄວາມຖືກຕ້ອງ Bearer, ຕາມດ້ວຍ API key ຂອງທ່ານ. ນີ້ແມ່ນມາດຕະຖານທົ່ວໄປ ແລະ ປອດໄພສໍາລັບການກວດສອບຄວາມຖືກຕ້ອງກັບບໍລິການ RESTful.

ການລືມທີ່ຈະລວມເອົາສ່ວນຫົວນີ້ ຫຼື ການໃຫ້ລະຫັດທີ່ບໍ່ຖືກຕ້ອງຈະສົ່ງຜົນໃຫ້ເກີດການຕອບສະໜອງຂໍ້ຜິດພາດ 401 Unauthorized. ໃຫ້ແນ່ໃຈວ່າສ່ວນຫົວນີ້ມີຢູ່ໃນທຸກ API call ທີ່ທ່ານເຮັດ, ຕັ້ງແຕ່ການອັບໂຫຼດເອກະສານເບື້ອງຕົ້ນໄປຈົນເຖິງການກວດສອບສະຖານະຂອງມັນ.
ຄວາມຕ້ອງການທີ່ສອດຄ່ອງນີ້ເຮັດໃຫ້ເຫດຜົນການກວດສອບຄວາມຖືກຕ້ອງໃນແອັບພລິເຄຊັນຂອງທ່ານງ່າຍຂຶ້ນ. ທ່ານສາມາດສ້າງລູກຄ້າ ຫຼື ຟັງຊັນທີ່ສາມາດນຳໃຊ້ຄືນໃໝ່ໄດ້ ເຊິ່ງຈະຕິດສ່ວນຫົວໃສ່ຄຳຮ້ອງຂໍຂາອອກທັງໝົດໂດຍອັດຕະໂນມັດ.

ຂັ້ນຕອນທີ 2: ການອັບໂຫຼດເອກະສານສໍາລັບການແປ

ຂະບວນການແປພາສາເລີ່ມຕົ້ນດ້ວຍການອັບໂຫຼດເອກະສານແຫຼ່ງຂໍ້ມູນຂອງທ່ານໄປທີ່ API ຂອງພວກເຮົາ. ອັນນີ້ແມ່ນເຮັດໄດ້ໂດຍການສົ່ງຄໍາຮ້ອງຂໍ POST ດ້ວຍ multipart/form-data ໄປຫາຈຸດປາຍທາງ /v3/document/translate.
ຕົວເຄື່ອງ (body) ຂອງຄໍາຮ້ອງຂໍຕ້ອງປະກອບມີໄຟລ໌ຕົວມັນເອງ, ພ້ອມກັບພາລາມິເຕີທີ່ລະບຸ source_lang (‘en’ ສໍາລັບພາສາອັງກິດ) ແລະ target_lang (‘ko’ ສໍາລັບພາສາເກົາຫຼີ). ຈາກນັ້ນ API ຈະຈັດຄິວເອກະສານເພື່ອດຳເນີນການ.

ເມື່ອການອັບໂຫຼດສຳເລັດ, API ຈະຕອບສະໜອງດ້ວຍວັດຖຸ JSON ທີ່ມີ document_id. ຕົວລະບຸສະເພາະນີ້ແມ່ນຈໍາເປັນສຳລັບການຕິດຕາມຄວາມຄືບໜ້າຂອງການແປຂອງທ່ານ.
ທ່ານຕ້ອງເກັບ ID ນີ້ໄວ້ໃນແອັບພລິເຄຊັນຂອງທ່ານ, ເພາະວ່າທ່ານຈະຕ້ອງການມັນສໍາລັບຂັ້ນຕອນຕໍ່ໄປຂອງການສອບຖາມສະຖານະ ແລະ ການດາວໂຫຼດໄຟລ໌ທີ່ຖືກແປສຸດທ້າຍ. ລະຫັດ Python ຕໍ່ໄປນີ້ສະແດງໃຫ້ເຫັນເຖິງຂະບວນການເຮັດວຽກທັງໝົດນີ້.

import requests
import time

# --- Configuration ---
API_KEY = "YOUR_API_KEY_HERE"
FILE_PATH = "path/to/your/english_document.docx"
SOURCE_LANG = "en"
TARGET_LANG = "ko"
BASE_URL = "https://api.doctranslate.io/v3"

# --- Set up headers for authentication ---
headers = {
    "Authorization": f"Bearer {API_KEY}"
}

# --- Step 1: Upload the document for translation ---
try:
    with open(FILE_PATH, "rb") as file_handle:
        files = {
            "file": (FILE_PATH.split('/')[-1], file_handle),
            "source_lang": (None, SOURCE_LANG),
            "target_lang": (None, TARGET_LANG)
        }
        
        print("Uploading document...")
        response = requests.post(f"{BASE_URL}/document/translate", headers=headers, files=files)
        response.raise_for_status() # Raise an exception for bad status codes
        
        upload_data = response.json()
        document_id = upload_data.get("document_id")
        print(f"Document uploaded successfully. Document ID: {document_id}")

        # --- Step 2: Poll for translation status ---
        status_url = f"{BASE_URL}/document/status/{document_id}"
        while True:
            print("Checking translation status...")
            status_response = requests.get(status_url, headers=headers)
            status_response.raise_for_status()
            status_data = status_response.json()
            
            if status_data.get("status") == "done":
                print("Translation is complete!")
                break
            elif status_data.get("status") == "error":
                raise Exception("An error occurred during translation.")
            
            time.sleep(10) # Wait 10 seconds before polling again

        # --- Step 3: Download the translated document ---
        print("Downloading translated document...")
        download_url = f"{BASE_URL}/document/download/{document_id}"
        download_response = requests.get(download_url, headers=headers)
        download_response.raise_for_status()

        with open("translated_korean_document.docx", "wb") as f:
            f.write(download_response.content)
        
        print("Translated document saved as translated_korean_document.docx")

except requests.exceptions.HTTPError as err:
    print(f"An HTTP error occurred: {err}")
except Exception as err:
    print(f"An error occurred: {err}")


ຂັ້ນຕອນທີ 3: ການສອບຖາມສະຖານະການແປ
ການແປເອກະສານແມ່ນການດໍາເນີນການແບບ asynchronous (ບໍ່ພ້ອມກັນ), ໂດຍສະເພາະສໍາລັບໄຟລ໌ຂະຫນາດໃຫຍ່ຫຼືສັບສົນ. ຫຼັງຈາກການອັບໂຫຼດ, ທ່ານຕ້ອງກວດສອບສະຖານະການແປເປັນໄລຍະໂດຍໃຊ້ document_id ທີ່ທ່ານໄດ້ຮັບ.
 ອັນນີ້ແມ່ນເຮັດໄດ້ໂດຍການສົ່ງຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດປາຍທາງ /v3/document/status/{document_id}. ວິທີການທີ່ບໍ່ມີການບລັອກນີ້ຮັບປະກັນວ່າແອັບພລິເຄຊັນຂອງທ່ານຍັງຄົງຕອບສະໜອງໄດ້ໃນຂະນະທີ່ລໍຖ້າການແປສຳເລັດ.
ຈຸດປາຍທາງສະຖານະຈະສົ່ງຄືນວັດຖຸ JSON ທີ່ມີຟິວ status. ຟິວນີ້ຈະຊີ້ບອກສະຖານະປັດຈຸບັນ, ເຊັ່ນ: queued, processing, done, ຫຼື error.
 ແອັບພລິເຄຊັນຂອງທ່ານຄວນປະຕິບັດ polling loop ທີ່ກວດເບິ່ງຈຸດປາຍທາງນີ້ທຸກໆສອງສາມວິນາທີ. ເມື່ອສະຖານະປ່ຽນເປັນ done, ທ່ານສາມາດດໍາເນີນການໄປຫາຂັ້ນຕອນສຸດທ້າຍຂອງການດາວໂຫຼດຜົນໄດ້ຮັບ.
ຂັ້ນຕອນທີ 4: ການດາວໂຫຼດເອກະສານທີ່ຖືກແປແລ້ວ
ເມື່ອສະຖານະຖືກຢືນຢັນວ່າເປັນ done, ເອກະສານພາສາເກົາຫຼີທີ່ຖືກແປແລ້ວແມ່ນພ້ອມສຳລັບການດາວໂຫຼດ. ທ່ານສາມາດດຶງເອົາມັນຄືນໄດ້ໂດຍການສ້າງຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດປາຍທາງ /v3/document/download/{document_id}.
 ຄໍາຮ້ອງຂໍນີ້ຈະສົ່ງຄືນຂໍ້ມູນຖານສອງ (binary data) ຂອງໄຟລ໌ທີ່ຖືກແປສຸດທ້າຍ. ແອັບພລິເຄຊັນຂອງທ່ານຈໍາເປັນຕ້ອງໄດ້ຖືກກະກຽມເພື່ອນໍາໃຊ້ binary stream ນີ້ ແລະ ບັນທຶກມັນໄວ້ໃນໄຟລ໌ທີ່ມີສ່ວນຂະຫຍາຍທີ່ເໝາະສົມ.
ໄຟລ໌ທີ່ຖືກດາວໂຫຼດຈະມີຮູບແບບດຽວກັນກັບເອກະສານແຫຼ່ງຕົ້ນສະບັບ. ຕົວຢ່າງ, ຖ້າທ່ານອັບໂຫຼດໄຟລ໌ DOCX, ທ່ານຈະໄດ້ຮັບໄຟລ໌ DOCX ທີ່ຖືກແປຢ່າງສົມບູນໃນການຕອບສະໜອງ.
 The API ຮັບປະກັນວ່າໂຄງສ້າງ, ການຈັດວາງ, ແລະ ຮູບແບບຖືກຮັກສາໄວ້ໃກ້ຄຽງກັບຕົ້ນສະບັບເທົ່າທີ່ເປັນໄປໄດ້. ອັນນີ້ເຮັດໃຫ້ຂະບວນການເຊື່ອມໂຍງສໍາເລັດຈາກຕົ້ນຈົນຈົບ.
ຂໍ້ຄວນພິຈາລະນາທີ່ສຳຄັນເມື່ອຈັດການລັກສະນະສະເພາະຂອງພາສາເກົາຫຼີ
ເມື່ອໃຊ້ API ການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ, ມັນເປັນປະໂຫຍດທີ່ຈະເຂົ້າໃຈບາງລັກສະນະດ້ານພາສາສາດ ແລະ ເຕັກນິກຂອງພາສາເກົາຫຼີ. ໃນຂະນະທີ່ API ຂອງພວກເຮົາຈັດການກັບຄວາມສັບສົນເຫຼົ່ານີ້ໂດຍອັດຕະໂນມັດ, ຄວາມຮັບຮູ້ສາມາດຊ່ວຍໃຫ້ທ່ານບັນລຸຜົນໄດ້ຮັບທີ່ດີກວ່າ.
 ຂໍ້ຄວນພິຈາລະນາເຫຼົ່ານີ້ມີຕັ້ງແຕ່ການສະແດງຕົວອັກສອນ ແລະ ຕົວອັກສອນໄປຈົນເຖິງດ້ານວັດທະນະທຳ ເຊັ່ນ: ຄວາມເປັນທາງການ. ການແກ້ໄຂພວກມັນຮັບປະກັນວ່າຜົນຜະລິດສຸດທ້າຍບໍ່ພຽງແຕ່ຖືກຕ້ອງຕາມຫຼັກພາສາສາດເທົ່ານັ້ນ ແຕ່ຍັງເໝາະສົມທາງດ້ານວັດທະນະທຳ ແລະ ຖືກນໍາສະເໜີແບບມືອາຊີບ.
ຊຸດຕົວອັກສອນ ແລະ ການເຂົ້າລະຫັດທີ່ຖືກຈັດການໂດຍອັດຕະໂນມັດ
ສິ່ງທ້າທາຍທາງດ້ານເຕັກນິກຕົ້ນຕໍ, ການເຂົ້າລະຫັດຕົວອັກສອນ, ແມ່ນຖືກຈັດການຢ່າງສົມບູນໂດຍ The Doctranslate API. ທ່ານບໍ່ຈໍາເປັນຕ້ອງກັງວົນກ່ຽວກັບການປ່ຽນລະຫວ່າງຊຸດຕົວອັກສອນທີ່ແຕກຕ່າງກັນ.
 ລະບົບຂອງພວກເຮົາປະມວນຜົນຂໍ້ຄວາມທັງໝົດເປັນ UTF-8 ພາຍໃນ, ເຊິ່ງເປັນມາດຕະຖານສາກົນທີ່ຮອງຮັບ Hangul ແລະ ໂດຍພື້ນຖານແລ້ວແມ່ນທຸກພາສາອື່ນໆຂອງໂລກ. ອັນນີ້ກໍາຈັດຄວາມສ່ຽງຂອງ mojibake ໄດ້ຢ່າງສົມບູນ ແລະ ຮັບປະກັນວ່າຕົວອັກສອນເກົາຫຼີທັງໝົດຖືກສະແດງຢ່າງຖືກຕ້ອງ.
ເມື່ອທ່ານອັບໂຫຼດເອກະສານພາສາອັງກິດ ແລະ ຮ້ອງຂໍການແປພາສາເກົາຫຼີ, ເຄື່ອງຈັກຂອງພວກເຮົາຈະຈັດການການປ່ຽນໃຈເຫຼື່ອມໃສທີ່ຈຳເປັນທັງໝົດ. ເອກະສານສຸດທ້າຍທີ່ທ່ານດາວໂຫຼດຈະຖືກເຂົ້າລະຫັດຢ່າງຖືກຕ້ອງ ແລະ ພ້ອມທີ່ຈະນໍາໃຊ້.
 ນີ້ແມ່ນຜົນປະໂຫຍດຫຼັກຂອງການໃຊ້ບໍລິການພິເສດ, ຊ່ວຍປະຢັດທ່ານຈາກການຂຽນເຫດຜົນການກວດຫາການເຂົ້າລະຫັດ ແລະ ການປ່ຽນໃຈເຫຼື່ອມໃສທີ່ສັບສົນ ແລະ ມີແນວໂນ້ມທີ່ຈະເກີດຂໍ້ຜິດພາດໃນແອັບພລິເຄຊັນຂອງທ່ານເອງ.
ຂໍ້ຄວນພິຈາລະນາກ່ຽວກັບຕົວອັກສອນ ແລະ ການຈັດຮູບແບບ
ຕົວອັກສອນ Hangul ພາສາເກົາຫຼີມີຄວາມໜາແໜ້ນທາງສາຍຕາ ແລະ ໂຄງສ້າງທີ່ແຕກຕ່າງກັນເມື່ອທຽບກັບຕົວອັກສອນລາຕິນ. ຕົວອັກສອນທີ່ເຮັດວຽກໄດ້ດີສໍາລັບພາສາອັງກິດອາດຈະບໍ່ຮອງຮັບຕົວອັກສອນເກົາຫຼີ ຫຼື ອາດຈະສະແດງພວກມັນບໍ່ດີ.
 ເຄື່ອງຈັກການແປຂອງພວກເຮົາປະກອບມີກົນໄກການປ່ຽນຕົວອັກສອນທີ່ຊັບຊ້ອນ. ຖ້າເອກະສານຕົ້ນສະບັບໃຊ້ຕົວອັກສອນທີ່ບໍ່ມີຮູບສັນຍາລັກ (glyphs) ພາສາເກົາຫຼີ, API ຈະທົດແທນມັນຢ່າງສະຫຼາດດ້ວຍຕົວອັກສອນເກົາຫຼີທີ່ເໝາະສົມ ເຊັ່ນ: Malgun Gothic ຫຼື Noto Sans KR ເພື່ອຮັບປະກັນຄວາມສາມາດໃນການອ່ານ.
ຂະບວນການນີ້ຊ່ວຍຮັກສາຮູບລັກສະນະທີ່ເປັນມືອາຊີບຂອງເອກະສານ. ໃນຂະນະທີ່ການທົດແທນອັດຕະໂນມັດເຮັດວຽກໄດ້ດີໃນກໍລະນີສ່ວນໃຫຍ່, ສໍາລັບເອກະສານທີ່ມີຮູບແບບສູງ, ທ່ານອາດຈະຕ້ອງການຈັດຮູບແບບແມ່ແບບລ່ວງໜ້າດ້ວຍຕົວອັກສອນທີ່ເຂົ້າກັນໄດ້ທົ່ວໂລກ.
 ວິທີການທີ່ມີການເຄື່ອນໄຫວລ່ວງໜ້ານີ້ສາມາດໃຫ້ທ່ານຄວບຄຸມຜົນຜະລິດສາຍຕາສຸດທ້າຍໄດ້ຫຼາຍຂຶ້ນ. ຢ່າງໃດກໍຕາມ, ສໍາລັບກໍລະນີການນໍາໃຊ້ສ່ວນໃຫຍ່, ພຶດຕິກໍາເລີ່ມຕົ້ນຂອງ API ຂອງພວກເຮົາສະຫນອງຜົນໄດ້ຮັບທີ່ດີເລີດ ແລະ ບໍ່ຕິດຂັດ.
ການແກ້ໄຂຄວາມເປັນທາງການ ແລະ ນໍ້າສຽງ
ພາສາເກົາຫຼີມີລະບົບທີ່ສັບສົນຂອງຄຳສັບຍົກຍ້ອງ ແລະ ລະດັບຄວາມເປັນທາງການ (ເປັນທີ່ຮູ້ຈັກກັນໃນນາມ Jondaemal ສໍາລັບທາງການ ແລະ Banmal ສໍາລັບການເວົ້າແບບບໍ່ເປັນທາງການ). ການແປໂດຍກົງຈາກພາສາອັງກິດອາດຈະບໍ່ສາມາດຈັບເອົານໍ້າສຽງທີ່ຖືກຕ້ອງສຳລັບຜູ້ຊົມເປົ້າໝາຍໄດ້ສະເໝີໄປ.
 ແບບຈໍາລອງການແປທີ່ໃຊ້ໂດຍ API ແມ່ນໄດ້ຮັບການຝຶກອົບຮົມກ່ຽວກັບຊຸດຂໍ້ມູນຈໍານວນຫຼວງຫຼາຍ ແລະ ໂດຍທົ່ວໄປແລ້ວແມ່ນມີຄວາມສາມາດໃນການເລືອກນໍ້າສຽງທີ່ເປັນກາງ, ເປັນມືອາຊີບທີ່ເໝາະສົມສຳລັບເອກະສານທາງທຸລະກິດ. ອັນນີ້ແມ່ນພຽງພໍສໍາລັບຄວາມຕ້ອງການໃນການແປມາດຕະຖານສ່ວນໃຫຍ່.
ສຳລັບແອັບພລິເຄຊັນທີ່ຮຽກຮ້ອງໃຫ້ມີລະດັບຄວາມເປັນທາງການສະເພາະຫຼາຍ, ທ່ານອາດຈະພິຈາລະນາຄຸນສົມບັດຂັ້ນສູງ ເຊັ່ນ: ພົດຈະນານຸກົມ (glossaries). ພົດຈະນານຸກົມຊ່ວຍໃຫ້ທ່ານສາມາດກໍານົດການແປສະເພາະສໍາລັບຄໍາສັບທີ່ສໍາຄັນ, ຮັບປະກັນຄວາມສອດຄ່ອງຂອງຍີ່ຫໍ້ ແລະ ຄໍາສັບທີ່ຖືກຕ້ອງ.
 ໃນຂະນະທີ່ການແປພື້ນຖານໃຫ້ຄວາມຖືກຕ້ອງສູງ, ການໃຊ້ພົດຈະນານຸກົມສຳລັບຄຳສັບສະເພາະອຸດສາຫະກຳ ຫຼື ສະເພາະຍີ່ຫໍ້ສາມາດຍົກສູງຄຸນນະພາບຂອງເອກະສານສຸດທ້າຍໃຫ້ສູງຂຶ້ນອີກ. ອັນນີ້ເຮັດໃຫ້ທ່ານມີການຄວບຄຸມເພີ່ມເຕີມຕໍ່ກັບຄວາມແຕກຕ່າງທາງດ້ານພາສາສາດຂອງຜົນຜະລິດ.
ບົດສະຫຼຸບ: ການແກ້ໄຂບັນຫາທີ່ເຂັ້ມແຂງສໍາລັບນັກພັດທະນາ
ການເຊື່ອມໂຍງ API ການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາເກົາຫຼີ ນໍາສະເໜີອຸປະສັກທາງດ້ານເຕັກນິກຈໍານວນຫລາຍ, ຕັ້ງແຕ່ການຮັກສາການຈັດວາງເອກະສານໄປຈົນເຖິງການຄຸ້ມຄອງການເຂົ້າລະຫັດຕົວອັກສອນທີ່ຊັບຊ້ອນ. The Doctranslate API ແມ່ນຖືກສ້າງຂຶ້ນເພື່ອແກ້ໄຂບັນຫາເຫຼົ່ານີ້ໂດຍສະເພາະ, ສະໜອງການແກ້ໄຂບັນຫາທີ່ເຊື່ອຖືໄດ້ ແລະ ມີປະສິດທິພາບສຳລັບນັກພັດທະນາ.
 ໂດຍການຫຍໍ້ຄວາມສັບສົນຂອງການແຍກວິເຄາະໄຟລ໌ ແລະ ສິ່ງທ້າທາຍທາງດ້ານພາສາສາດ, ບໍລິການ RESTful ຂອງພວກເຮົາຊ່ວຍໃຫ້ທ່ານສາມາດເພີ່ມຄວາມສາມາດໃນການແປທີ່ມີປະສິດທິພາບ, ມີຄວາມຖືກຕ້ອງສູງໃຫ້ກັບແອັບພລິເຄຊັນຂອງທ່ານໂດຍມີຄວາມພະຍາຍາມໜ້ອຍທີ່ສຸດ.
ຄູ່ມືຂັ້ນຕອນຕໍ່ຂັ້ນຕອນສະແດງໃຫ້ເຫັນວ່າຂະບວນການເຮັດວຽກທີ່ເຂົ້າໃຈງ່າຍ, ແບບ asynchronous ຂອງພວກເຮົາ—ຕັ້ງແຕ່ການອັບໂຫຼດເອກະສານໄປຈົນເຖິງການດາວໂຫຼດການແປທີ່ສໍາເລັດ—ແມ່ນງ່າຍຕໍ່ການນໍາໃຊ້. ດ້ວຍຄຸນສົມບັດຕ່າງໆ ເຊັ່ນ: ການຮອງຮັບຮູບແບບທີ່ກວ້າງຂວາງ ແລະ ການທົດແທນຕົວອັກສອນອັດຕະໂນມັດ, ທ່ານສາມາດໝັ້ນໃຈໄດ້ວ່າເອກະສານພາສາເກົາຫຼີສຸດທ້າຍຈະຖືກຕ້ອງ ແລະ ເປັນມືອາຊີບ.
 ສຳລັບຂໍ້ມູນລະອຽດເພີ່ມເຕີມ, ກະລຸນາອ້າງອີງເຖິງເອກະສານ API ທາງການຂອງພວກເຮົາ. ພວກເຮົາຂໍແນະນຳໃຫ້ທ່ານເລີ່ມສ້າງຕັ້ງແຕ່ນີ້ ແລະ ປົດລັອກການສື່ສານທົ່ວໂລກທີ່ລຽບງ່າຍສຳລັບຜູ້ໃຊ້ຂອງທ່ານ.