API ຈາກພາສາອັງກິດຫາພາສາປໍຕູກິສ: ເຮັດໃຫ້ການແປເອກະສານເປັນແບບອັດຕະໂນມັດ

ຄວາມສັບສົນທີ່ເຊື່ອງໄວ້ຂອງການແປເອກະສານຜ່ານ API

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

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

ການຈັດການການເຂົ້າລະຫັດຕົວອັກສອນສຳລັບພາສາປໍຕູກິສ

ພາສາປໍຕູກິສແມ່ນອຸດົມສົມບູນໄປດ້ວຍເຄື່ອງໝາຍເນັ້ນສຽງ, ເຊັ່ນ: cedillas (ç), tildes (ã, õ), ແລະສໍານຽງຕ່າງໆ (á, ê, ô).
ຖ້າບໍ່ໄດ້ຮັບການຈັດການຢ່າງຖືກຕ້ອງ, ຕົວອັກສອນເຫຼົ່ານີ້ສາມາດຖືກເສຍຫາຍໄດ້ງ່າຍ, ປາກົດເປັນ mojibake ຫຼືເຄື່ອງໝາຍຄຳຖາມໃນເອກະສານສຸດທ້າຍ.
API ການແປເອກະສານຈາກພາສາອັງກິດຫາພາສາປໍຕູກິສທີ່ເຊື່ອຖືໄດ້ຕ້ອງຈັດການຊຸດຕົວອັກສອນໂດຍທຳມະຊາດ, ຮັບປະກັນວ່າຂໍ້ຄວາມທັງໝົດຖືກປະມວນຜົນ ແລະ ສະແດງຢ່າງຖືກຕ້ອງໃນ UTF-8 ເພື່ອຮັກສາຄວາມຖືກຕ້ອງທາງດ້ານພາສາ.

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

ສິ່ງທ້າທາຍໃນການຮັກສາຮູບແບບທີ່ສັບສົນ

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

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

ການເຂົ້າໃຈໂຄງສ້າງໄຟລ໌ທີ່ສັບສົນ

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

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

The Doctranslate API: ວິທີແກ້ໄຂບັນຫາສຳລັບນັກພັດທະນາເປັນອັນດັບທຳອິດ

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

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

ສ້າງຂຶ້ນໃນ Simple REST Architecture

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

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

ການຕອບສະໜອງຂອງ JSON ທີ່ຄາດເດົາໄດ້ສຳລັບການເຊື່ອມໂຍງງ່າຍ

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

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

ຄູ່ມືຂັ້ນຕອນຕໍ່ຂັ້ນຕອນໃນການລວມ API ການແປເອກະສານຈາກພາສາອັງກິດຫາພາສາປໍຕູກິສ

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

ຂັ້ນຕອນທີ 1: ການໄດ້ຮັບ API Key ຂອງທ່ານ

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

ມັນເປັນສິ່ງສໍາຄັນທີ່ຈະຮັກສາ API key ຂອງທ່ານໃຫ້ປອດໄພ ແລະບໍ່ໃຫ້ມັນເປີດເຜີຍໃນລະຫັດ client-side ຫຼື public repositories.
ປະຕິບັດຕໍ່ມັນຄືກັບລະຫັດຜ່ານ ແລະເກັບມັນໄວ້ໃນບ່ອນທີ່ປອດໄພ, ເຊັ່ນ: environment variable ຫຼື ບໍລິການຈັດການຄວາມລັບ.
ຄໍາຮ້ອງຂໍ API ຕໍ່ໄປທັງໝົດຈະຕ້ອງປະກອບມີ key ນີ້ຢູ່ໃນ header `x-api-key` ສໍາລັບການຢືນຢັນຕົວຕົນ.

ຂັ້ນຕອນທີ 2: ການເຂົ້າໃຈຈຸດເຊື່ອມຕໍ່ການແປຫຼັກ

ຈຸດເຊື່ອມຕໍ່ຫຼັກສໍາລັບການລິເລີ່ມການແປແມ່ນ `/v3/document/translate`.
ຈຸດເຊື່ອມຕໍ່ນີ້ຍອມຮັບຄໍາຮ້ອງຂໍ `POST` ດ້ວຍ payload `multipart/form-data` ທີ່ມີເອກະສານຕົ້ນສະບັບແລະຕົວກໍານົດການແປ.
ຕົວກໍານົດການທີ່ສໍາຄັນແມ່ນ `source_document`, `source_language`, ແລະ `target_language`, ເຊິ່ງລະບຸໄຟລ໌ທີ່ຈະຖືກແປ ແລະຄູ່ພາສາ.

ສໍາລັບການແປຈາກພາສາອັງກິດຫາພາສາປໍຕູກິສ, ທ່ານຈະກໍານົດ `source_language` ເປັນ `en` ແລະ `target_language` ເປັນ `pt`.
API ຍັງຮອງຮັບການແປສະເພາະສໍານຽງ, ເຊິ່ງພວກເຮົາຈະກວມເອົາໃນພາຍຫຼັງ, ເຮັດໃຫ້ມີການທ້ອງຖິ່ນທີ່ຊັດເຈນກວ່າ.
ເມື່ອຄໍາຮ້ອງຂໍສໍາເລັດ, ຈຸດເຊື່ອມຕໍ່ນີ້ຈະສົ່ງຄືນການຕອບສະໜອງ JSON ທີ່ມີ `document_id` ທີ່ຕ້ອງການສໍາລັບຂັ້ນຕອນຕໍ່ໄປ.

ຂັ້ນຕອນທີ 3: ການສົ່ງຄໍາຮ້ອງຂໍການແປຄັ້ງທໍາອິດຂອງທ່ານ (ຕົວຢ່າງ Python)

ຕອນນີ້, ໃຫ້ເຮົາແປເອກະສານໂດຍໃຊ້ Python ແລະ library `requests` ທີ່ນິຍົມ.
ຂໍ້ຄວາມລະຫັດນີ້ສະແດງວິທີການສ້າງຄໍາຮ້ອງຂໍ, ລວມທັງ headers ສໍາລັບການຢືນຢັນຕົວຕົນແລະ form data ສໍາລັບໄຟລ໌ແລະຕົວກໍານົດການ.
ໃຫ້ແນ່ໃຈວ່າທ່ານໄດ້ຕິດຕັ້ງ `requests` (`pip install requests`) ແລະປ່ຽນແທນ `’YOUR_API_KEY’` ແລະ `’path/to/your/document.docx’` ດ້ວຍຄ່າຕົວຈິງຂອງທ່ານ.

ຕົວຢ່າງນີ້ຕັ້ງຄ່າ URL ຈຸດເຊື່ອມຕໍ່ API, headers, ແລະ multipart form data.
`source_document` ຖືກເປີດຢູ່ໃນ binary read mode (`’rb’`), ເຊິ່ງເປັນສິ່ງຈໍາເປັນສໍາລັບການອັບໂຫລດໄຟລ໌.
ຫຼັງຈາກສົ່ງຄໍາຮ້ອງຂໍ, script ຈະພິມການຕອບສະຫນອງ JSON ຈາກເຊີບເວີ, ເຊິ່ງຈະລວມເອົາ `document_id` ຂອງທ່ານ.

import requests

# Define your API key and the path to your source document
API_KEY = 'YOUR_API_KEY'
FILE_PATH = 'path/to/your/document.docx'

# The API endpoint for document translation
url = 'https://developer.doctranslate.io/v3/document/translate'

# Set up the headers with your API key for authentication
headers = {
    'x-api-key': API_KEY
}

# Prepare the multipart/form-data payload
files = {
    'source_document': (FILE_PATH.split('/')[-1], open(FILE_PATH, 'rb')),
    'source_language': (None, 'en'),
    'target_language': (None, 'pt'),
}

# Make the POST request to the API
response = requests.post(url, headers=headers, files=files)

# Print the server's response
print(response.json())
# Expected output: {'document_id': 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'}

ຂັ້ນຕອນທີ 4: ການກວດສອບສະຖານະການແປ
ເນື່ອງຈາກການແປເອກະສານສາມາດໃຊ້ເວລາຂຶ້ນກັບຂະຫນາດແລະຄວາມສັບສົນຂອງໄຟລ໌, ຂະບວນການແມ່ນ asynchronous.
 ທ່ານຈໍາເປັນຕ້ອງສອບຖາມຈຸດເຊື່ອມຕໍ່ສະຖານະເພື່ອເພື່ອກວດເບິ່ງວ່າການແປຂອງທ່ານສໍາເລັດແລ້ວບໍໂດຍໃຊ້ `document_id` ຈາກຂັ້ນຕອນກ່ອນໜ້ານີ້.
 ຈຸດເຊື່ອມຕໍ່ແມ່ນ `/v3/document/status/{document_id}`, ບ່ອນທີ່ທ່ານປ່ຽນແທນ `{document_id}` ດ້ວຍ ID ທີ່ທ່ານໄດ້ຮັບ.
ຄໍາຮ້ອງຂໍ `GET` ໄປຫາຈຸດເຊື່ອມຕໍ່ນີ້ຈະສົ່ງຄືນສະຖານະປັດຈຸບັນ, ເຊິ່ງສາມາດເປັນ `processing`, `completed`, ຫຼື `failed`.
 ໃນແອັບພລິເຄຊັນໃນໂລກຕົວຈິງ, ທ່ານຈະປະຕິບັດກົນໄກການສອບຖາມ, ກວດສອບທຸກໆສອງສາມວິນາທີຈົນກ່ວາສະຖານະປ່ຽນເປັນ `completed`.
 ເມື່ອສໍາເລັດ, ທ່ານສາມາດດໍາເນີນການໄປຫາຂັ້ນຕອນສຸດທ້າຍຂອງການດາວໂຫລດໄຟລ໌ທີ່ຖືກແປ.
ຂັ້ນຕອນທີ 5: ການດຶງເອົາເອກະສານປໍຕູກິສທີ່ຖືກແປຂອງທ່ານ
ດ້ວຍສະຖານະການແປທີ່ຢືນຢັນວ່າເປັນ `completed`, ທ່ານສາມາດດາວໂຫລດເອກະສານສຸດທ້າຍໄດ້ແລ້ວ.
 ຈຸດເຊື່ອມຕໍ່ດາວໂຫລດແມ່ນ `/v3/document/result/{document_id}`, ເຊິ່ງທ່ານເຂົ້າເຖິງດ້ວຍຄໍາຮ້ອງຂໍ `GET`.
 ຄໍາຮ້ອງຂໍນີ້ຈະສົ່ງຄືນຂໍ້ມູນໄຟລ໌ດິບສໍາລັບເອກະສານປໍຕູກິສທີ່ຖືກແປຂອງທ່ານ, ເຊິ່ງທ່ານສາມາດບັນທຶກໄວ້ໃນລະບົບໄຟລ໌ທ້ອງຖິ່ນຂອງທ່ານ.
header `Content-Disposition` ໃນການຕອບສະຫນອງຈະແນະນໍາຊື່ໄຟລ໌ສໍາລັບເອກະສານທີ່ຖືກແປ, ເຊິ່ງທ່ານສາມາດນໍາໃຊ້ໃນເວລາທີ່ບັນທຶກໄຟລ໌.
 ໃຫ້ແນ່ໃຈວ່າເປີດໄຟລ໌ທ້ອງຖິ່ນໃນ binary write mode (`’wb’`) ເພື່ອບັນທຶກ data stream ທີ່ເຂົ້າມາຢ່າງຖືກຕ້ອງ.
 ນີ້ສໍາເລັດວົງຈອນເຕັມຂອງການແປເອກະສານຈາກພາສາອັງກິດຫາພາສາປໍຕູກິສແບບໂປຣແກຣມ.
ການພິຈາລະນາຂັ້ນສູງສໍາລັບການແປພາສາປໍຕູກິສ
ການແປເປັນພາສາປໍຕູກິສກ່ຽວຂ້ອງກັບຫຼາຍກວ່າພຽງແຕ່ການປ່ຽນຄໍາສັບ; ມັນຮຽກຮ້ອງໃຫ້ມີຄວາມເຂົ້າໃຈກ່ຽວກັບຄວາມແຕກຕ່າງທາງດ້ານວັດທະນະທໍາແລະພາສາ.
 ການແປທີ່ມີຄຸນນະພາບສູງຕ້ອງຄໍານຶງເຖິງສໍານຽງທ້ອງຖິ່ນ, ຈັດການຕົວອັກສອນພິເສດຢ່າງຖືກຕ້ອງ, ແລະຮັກສາຄວາມສອດຄ່ອງຂອງຍີ່ຫໍ້.
 The Doctranslate API ໃຫ້ຄຸນສົມບັດທີ່ຊ່ວຍໃຫ້ນັກພັດທະນາສາມາດຈັດການຄວາມລະອຽດອ່ອນເຫຼົ່ານີ້ໄດ້ຢ່າງມີປະສິດທິພາບສໍາລັບຜົນໄດ້ຮັບການທ້ອງຖິ່ນທີ່ດີກວ່າ.
ການຄອບຄອງສໍານຽງພາສາປໍຕູກິສ: Brazil (pt-BR) ທຽບກັບ Portugal (pt-PT)
ພາສາປໍຕູກິສມີສອງສໍານຽງຫຼັກ: Brazilian Portuguese (`pt-BR`) ແລະ European Portuguese (`pt-PT`).
 ໃນຂະນະທີ່ສາມາດເຂົ້າໃຈເຊິ່ງກັນແລະກັນໄດ້, ພວກເຂົາມີຄວາມແຕກຕ່າງທີ່ຫນ້າສັງເກດໃນຄໍາສັບ, ໄວຍະກອນ, ແລະການກ່າວເຖິງຢ່າງເປັນທາງການ.
 ການໃຊ້ສໍານຽງທີ່ຖືກຕ້ອງແມ່ນສໍາຄັນສໍາລັບການເຊື່ອມຕໍ່ກັບກຸ່ມເປົ້າຫມາຍຂອງທ່ານແລະຫຼີກເວັ້ນການແປທີ່ຮູ້ສຶກວ່າບໍ່ທໍາມະຊາດຫຼືບໍ່ຖືກຕ້ອງ.
The Doctranslate API ຊ່ວຍໃຫ້ທ່ານສາມາດລະບຸສໍານຽງເປົ້າໝາຍໂດຍກົງໃນຄໍາຮ້ອງຂໍການແປຂອງທ່ານ.
 ໂດຍການກໍານົດຕົວກໍານົດການ `target_language` ເປັນ `pt-BR` ຫຼື `pt-PT`, ທ່ານສາມາດຮັບປະກັນວ່າເຄື່ອງຈັກແປໃຊ້ຄໍາສັບແລະສົນທິສັນຍາທີ່ເຫມາະສົມ.
 ລະດັບການຄວບຄຸມນີ້ແມ່ນຈໍາເປັນສໍາລັບການສ້າງເນື້ອຫາທີ່ຖືກທ້ອງຖິ່ນຢ່າງແທ້ຈິງທີ່ດຶງດູດຜູ້ໃຊ້ທັງໃນ Brazil ຫຼື Portugal.
ການຈັດການ Diacritics ແລະຕົວອັກສອນພິເສດດ້ວຍ UTF-8
ດັ່ງທີ່ໄດ້ກ່າວມາຂ້າງເທິງ, ການຈັດການຕົວອັກສອນພິເສດຂອງປໍຕູກິສ (`ç`, `ã`, `é`, etc.) ຢ່າງຖືກຕ້ອງແມ່ນບໍ່ສາມາດຕໍ່ລອງໄດ້ສໍາລັບການແປແບບມືອາຊີບ.
 The Doctranslate API ຖືກສ້າງຂຶ້ນໃນສະຖາປັດຕະຍະກໍາທີ່ສອດຄ່ອງກັບ UTF-8, ຮັບປະກັນວ່າຂໍ້ມູນຂໍ້ຄວາມທັງໝົດຖືກຮັກສາໄວ້ຢ່າງສົມບູນຕະຫຼອດທໍ່ສົ່ງການແປ.
 ນີ້ຫມາຍຄວາມວ່າທ່ານບໍ່ຈໍາເປັນຕ້ອງກັງວົນກ່ຽວກັບບັນຫາການເຂົ້າລະຫັດຕົວອັກສອນໃນເອກະສານທີ່ຖືກແປຂອງທ່ານ.
ເມື່ອລວມ API, ມັນຍັງຄົງເປັນການປະຕິບັດທີ່ດີທີ່ສຸດເພື່ອຮັບປະກັນວ່າສະພາບແວດລ້ອມຂອງແອັບພລິເຄຊັນຂອງທ່ານເອງກໍ່ຖືກຕັ້ງຄ່າໃຫ້ຈັດການ UTF-8.
 ນີ້ປະກອບມີວິທີທີ່ທ່ານອ່ານຂໍ້ມູນໄຟລ໌, ປະມວນຜົນການຕອບສະຫນອງ JSON, ແລະບັນທຶກເອກະສານທີ່ຖືກແປສຸດທ້າຍ.
 ໂດຍການຮັກສາການສອດຄ່ອງກັບ UTF-8 ຈາກຕົ້ນຈົນຈົບ, ທ່ານຮັບປະກັນຄວາມຄົບຖ້ວນທາງດ້ານພາສາຂອງເນື້ອຫາຂອງທ່ານ.
ການນຳໃຊ້ Glossaries ເພື່ອຄວາມສອດຄ່ອງຂອງຍີ່ຫໍ້ ແລະສຽງ
ການຮັກສາຄວາມສອດຄ່ອງຂອງຍີ່ຫໍ້ໃນທົ່ວພາສາທີ່ແຕກຕ່າງກັນແມ່ນສິ່ງທ້າທາຍທີ່ສໍາຄັນ, ໂດຍສະເພາະສໍາລັບຄໍາສັບດ້ານເຕັກນິກ, ຊື່ຜະລິດຕະພັນ, ຫຼືວະລີການຕະຫຼາດສະເພາະ.
 The Doctranslate API ຮອງຮັບການນໍາໃຊ້ glossaries, ເຊິ່ງຊ່ວຍໃຫ້ທ່ານສາມາດກໍານົດກົດລະບຽບການແປສະເພາະສໍາລັບຄໍາສັບສະເພາະ.
 ທ່ານສາມາດກໍານົດວ່າຄໍາສັບພາສາອັງກິດສະເພາະຄວນຖືກແປເປັນຄໍາສັບພາສາປໍຕູກິສສະເພາະສະເໝີ, ຫຼືວ່າມັນບໍ່ຄວນຖືກແປເລີຍ.
ຄຸນສົມບັດນີ້ໃຫ້ການຄວບຄຸມລະອຽດແກ່ທ່ານໃນການສົ່ງອອກການແປ, ຮັບປະກັນວ່າສຽງທີ່ເປັນເອກະລັກຂອງຍີ່ຫໍ້ຂອງທ່ານຍັງຄົງສອດຄ່ອງ.
 ໂດຍການສ້າງແລະນໍາໃຊ້ glossary ກັບຄໍາຮ້ອງຂໍ API ຂອງທ່ານ, ທ່ານສາມາດບັງຄັບມາດຕະຖານຄໍາສັບໂດຍອັດຕະໂນມັດ.
 ນີ້ຊ່ວຍຫຼຸດຜ່ອນຄວາມຈໍາເປັນສໍາລັບການແກ້ໄຂຫຼັງການແປດ້ວຍຕົນເອງ ແລະຊ່ວຍຮັກສາລະດັບຄຸນນະພາບ ແລະຄວາມສອດຄ່ອງໃນທົ່ວເອກະສານທີ່ຖືກແປຂອງທ່ານທັງໝົດ.
ບົດສະຫຼຸບ: ປັບປຸງຂັ້ນຕອນການເຮັດວຽກການແປຂອງທ່ານ
ການລວມ API ການແປເອກະສານຈາກພາສາອັງກິດຫາພາສາປໍຕູກິສແມ່ນວິທີທີ່ມີປະສິດທິພາບໃນການເຮັດໃຫ້ວຽກງານການທ້ອງຖິ່ນຂອງທ່ານເປັນແບບອັດຕະໂນມັດ ແລະຂະຫຍາຍຂະໜາດໄດ້.
 ໃນຂະນະທີ່ຂະບວນການດັ່ງກ່າວກ່ຽວຂ້ອງກັບຄວາມສັບສົນໃນການຈັດການເຊັ່ນ: ການຮັກສາຮູບແບບ ແລະການວິເຄາະໄຟລ໌, The Doctranslate API ໃຫ້ວິທີແກ້ໄຂທີ່ເຂັ້ມແຂງແລະເປັນມິດກັບນັກພັດທະນາ.
 ໂຄງສ້າງ REST ທີ່ງ່າຍດາຍ, ການຕອບສະໜອງ JSON ທີ່ຄາດເດົາໄດ້, ແລະຄຸນສົມບັດທີ່ມີປະສິດທິພາບສໍາລັບການຈັດການຄວາມແຕກຕ່າງທາງດ້ານພາສາ ເຮັດໃຫ້ມັນເປັນທາງເລືອກທີ່ເຫມາະສົມສໍາລັບທຸກແອັບພລິເຄຊັນ.
ໂດຍການປະຕິບັດຕາມຂັ້ນຕອນທີ່ໄດ້ກໍານົດໄວ້ໃນຄູ່ມືນີ້, ທ່ານສາມາດລວມການແປເອກະສານທີ່ມີຄຸນນະພາບສູງເຂົ້າໃນຂັ້ນຕອນການເຮັດວຽກຂອງທ່ານໄດ້ຢ່າງວ່ອງໄວ.
 ທ່ານສາມາດກໍາຈັດຂະບວນການດ້ວຍຕົນເອງ ແລະສົ່ງເນື້ອຫາທີ່ຖືກແປຢ່າງຖືກຕ້ອງໃຫ້ກັບຜູ້ໃຊ້ຂອງທ່ານໄວກວ່າທີ່ເຄີຍມີມາ.
 ເພື່ອຮຽນຮູ້ເພີ່ມເຕີມກ່ຽວກັບຄຸນສົມບັດຂັ້ນສູງເຊັ່ນ: ການຈັດການ glossary ແລະປະເພດໄຟລ໌ທີ່ຮອງຮັບ, ໃຫ້ແນ່ໃຈວ່າໄດ້ຄົ້ນຫາເອກະສານຂອງນັກພັດທະນາຢ່າງເປັນທາງການ.