API ພາສາອັງກິດ ເປັນ ພາສາອີຕາລີ: ການແປແບບອັດຕະໂນມັດ | ຄູ່ມືສໍາລັບນັກພັດທະນາ

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

ຄວາມສັບສົນຂອງການແປແບບໂປຣແກຣມ

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

ອຸປະສັກໃນການເຂົ້າລະຫັດຕົວອັກສອນ

ການເຂົ້າລະຫັດຕົວອັກສອນ ເປັນແຫຼ່ງທີ່ມາຂອງຂໍ້ຜິດພາດເລື້ອຍໆໃນລະບົບຫຼາຍພາສາ. ຂໍ້ຄວາມທີ່ຈັດການບໍ່ຖືກຕ້ອງສາມາດປາກົດວ່າເສຍຫາຍ ຫຼືອ່ານບໍ່ໄດ້ໝົດ.
ພາສາອີຕາລີໃຊ້ຕົວອັກສອນທີ່ມີເຄື່ອງໝາຍສຽງສູງເຊັ່ນ à, è, ì, ò, ແລະ ù. ຖ້າບໍ່ມີການຈັດການ UTF-8 ທີ່ສອດຄ່ອງກັນ, ສິ່ງເຫຼົ່ານີ້ອາດຈະສູນເສຍ ຫຼືຖືກບິດເບືອນໃນລະຫວ່າງການໂອນຂໍ້ມູນ.

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

ການຮັກສາຮູບແບບ ແລະ ໂຄງສ້າງຂອງເອກະສານ

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

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

ການຈັດການຮູບແບບໄຟລ໌ທີ່ສັບສົນ

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

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

ການຮັບປະກັນຄວາມຖືກຕ້ອງຂອງບໍລິບົດ

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

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

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

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

ສ້າງຂຶ້ນສໍາລັບນັກພັດທະນາ: ຫຼັກການ RESTful

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

ການຕອບສະໜອງຖືກສົ່ງໃນຮູບແບບ JSON response ທີ່ສະອາດ, ງ່າຍຕໍ່ການວິເຄາະ. ອັນນີ້ເຮັດໃຫ້ການຈັດການຂໍ້ຜິດພາດ ແລະການຈັດການສະຖານະໃນແອັບພລິເຄຊັນຂອງທ່ານງ່າຍຂຶ້ນ.
ບໍ່ຈໍາເປັນຕ້ອງມີ SDKs ຫຼື libraries ທີ່ສັບສົນ. ລູກຄ້າ HTTP ມາດຕະຖານແມ່ນທັງໝົດທີ່ທ່ານຕ້ອງການເພື່ອເລີ່ມຕົ້ນດ້ວຍບໍລິການຂອງພວກເຮົາ.

ການເຊື່ອມໂຍງ ແລະ ຂະບວນການເຮັດວຽກທີ່ບໍ່ມີຂໍ້ບົກຜ່ອງ

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

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

ຄວາມຖືກຕ້ອງ ແລະ ຄວາມໄວທີ່ບໍ່ມີໃຜທຽບເທົ່າ

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

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

ຄູ່ມືການເຊື່ອມໂຍງແບບຂັ້ນຕອນ

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

1. ການເອົາ API Key ຂອງທ່ານ

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

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

2. ເອັນພອຍການແປເອກະສານ

ຫຼັກຂອງບໍລິການແມ່ນເອັນພອຍການແປ. ທ່ານຈະສົ່ງຄໍາຮ້ອງຂໍ POST ໄປຫາ `/v2/document/translate` ເພື່ອເລີ່ມຕົ້ນວຽກໃໝ່.
ຄໍາຮ້ອງຂໍນີ້ຈະລວມມີໄຟລ໌ຕົ້ນສະບັບຂອງທ່ານ ແລະພາລາມິເຕີການແປ. API ຈະຈັດລຽງເອກະສານຂອງທ່ານສໍາລັບການປະມວນຜົນ.

ພາລາມິເຕີທີ່ຕ້ອງການແມ່ນຕົວໄຟລ໌ເອງ, ພາສາຕົ້ນສະບັບ, ແລະພາສາເປົ້າໝາຍ. ສໍາລັບຄູ່ມືນີ້, ພວກເຮົາຈະໃຊ້ `source_lang=’en’` ແລະ `target_lang=’it’`.
API ຈັດການການວິເຄາະໄຟລ໌ ແລະການສະກັດຂໍ້ຄວາມໂດຍອັດຕະໂນມັດ. ທ່ານພຽງແຕ່ໃຫ້ເອກະສານ ແລະກໍານົດພາສາ.

3. ການເຮັດ API Call ຄັ້ງທໍາອິດຂອງທ່ານ (ຕົວຢ່າງ Python)

ໃຫ້ສ້າງສະຄຣິບ Python ເພື່ອອັບໂຫລດເອກະສານສໍາລັບການແປ. ຕົວຢ່າງນີ້ໃຊ້ library `requests` ທີ່ນິຍົມ ເພື່ອຈັດການຄໍາຮ້ອງຂໍ HTTP.
ໃຫ້ແນ່ໃຈວ່າທ່ານມີໄຟລ໌ຊື່ `document.txt` ຢູ່ໃນໄດເຣັກທໍຣີດຽວກັນ. ນີ້ຈະເປັນໄຟລ໌ທີ່ພວກເຮົາແປຈາກພາສາອັງກິດ ເປັນ ພາສາອີຕາລີ.

ລະຫັດຕໍ່ໄປນີ້ສະແດງໃຫ້ເຫັນວິທີການຈັດໂຄງສ້າງຄໍາຮ້ອງຂໍ multipart/form-data. ມັນປະກອບມີໄຟລ໌ ແລະພາລາມິເຕີພາສາທີ່ຈໍາເປັນ.
ຈື່ໄວ້ວ່າໃຫ້ປ່ຽນແທນ `’YOUR_API_KEY’` ດ້ວຍ key ຕົວຈິງຈາກ dashboard ຂອງທ່ານ. ນີ້ແມ່ນສໍາຄັນສໍາລັບການກວດສອບສິດອໍານາດ.

import requests

# API key ຂອງທ່ານຈາກ dashboard ຂອງ Doctranslate
api_key = 'YOUR_API_KEY'

# ເສັ້ນທາງໄປຫາໄຟລ໌ທີ່ທ່ານຕ້ອງການແປ
file_path = 'document.txt'

# ເອັນພອຍ API ສໍາລັບການລິເລີ່ມການແປ
url = 'https://developer.doctranslate.io/v2/document/translate'

headers = {
    'Authorization': f'Bearer {api_key}'
}

data = {
    'source_lang': 'en',
    'target_lang': 'it'
}

with open(file_path, 'rb') as f:
    files = {'file': (f.name, f, 'text/plain')}
    
    # ສົ່ງຄໍາຮ້ອງຂໍໄປຫາ API
    response = requests.post(url, headers=headers, data=data, files=files)

if response.status_code == 200:
    # ເອົາ ID ເອກະສານຈາກການຕອບສະໜອງ JSON
    document_id = response.json().get('id')
    print(f'ໄດ້ເລີ່ມການແປສຳເລັດແລ້ວ. ID ເອກະສານ: {document_id}')
else:
    print(f'ຂໍ້ຜິດພາດ: {response.status_code}')
    print(response.json())
4. ການຈັດການການຕອບສະໜອງ JSON
ຫຼັງຈາກການຮ້ອງຂໍທີ່ປະສົບຜົນສຳເລັດ, API ຈະສົ່ງຄືນວັດຖຸ JSON. ການຕອບສະໜອງນີ້ມີ `id` ຂອງວຽກງານການແປທີ່ສ້າງຂຶ້ນໃໝ່. 
ທ່ານຈະໃຊ້ ID ນີ້ເພື່ອກວດເບິ່ງສະຖານະຂອງການແປ. ທ່ານຍັງຕ້ອງການມັນເພື່ອດາວໂຫຼດໄຟລ໌ທີ່ສໍາເລັດແລ້ວ.
ສະຖານະເບື້ອງຕົ້ນອາດຈະເປັນ `queued` ຫຼື `processing`. ທ່ານຈໍາເປັນຕ້ອງກວດເບິ່ງເອັນພອຍສະຖານະເປັນໄລຍະຈົນກວ່າມັນຈະປ່ຽນເປັນ `done`. 
ຂະບວນການ asynchronous ນີ້ແມ່ນເຫມາະສົມສໍາລັບການຈັດການເອກະສານຂະໜາດໃຫຍ່. ມັນປ້ອງກັນບໍ່ໃຫ້ແອັບພລິເຄຊັນຂອງທ່ານຖືກບລັອກໃນຂະນະທີ່ລໍຖ້າການແປສໍາເລັດ.
5. ການກວດສອບສະຖານະ ແລະ ການດາວໂຫຼດໄຟລ໌
ເພື່ອກວດເບິ່ງສະຖານະວຽກ, ທ່ານສົ່ງຄໍາຮ້ອງຂໍ GET ໄປຫາ `/v2/document/{id}`. ທ່ານຈະຕ້ອງ polling ເອັນພອຍນີ້ຈົນກວ່າສະຖານະຈະເປັນ `done`. 
ເມື່ອການແປສໍາເລັດ, ທ່ານສາມາດດາວໂຫລດໄຟລ໌ໄດ້. ຂັ້ນຕອນສຸດທ້າຍແມ່ນການເຮັດຄໍາຮ້ອງຂໍ GET ໄປຫາເອັນພອຍດາວໂຫຼດ.
ເອັນພອຍດາວໂຫຼດແມ່ນ `/v2/document/{id}/download`. ອັນນີ້ຈະສົ່ງຄືນໄຟລ໌ທີ່ຖືກແປແລ້ວດ້ວຍເນື້ອຫາ ແລະໂຄງສ້າງທີ່ຖືກຕ້ອງ. 
ສະຄຣິບ Python ຕໍ່ໄປນີ້ສະແດງໃຫ້ເຫັນວິທີການປະຕິບັດກົນໄກ polling ແບບງ່າຍດາຍ. ມັນກວດເບິ່ງສະຖານະທຸກໆສອງສາມວິນາທີ ແລະຫຼັງຈາກນັ້ນດາວໂຫລດໄຟລ໌.
import requests
import time

api_key = 'YOUR_API_KEY'

# ໃຊ້ ID ຈາກຂັ້ນຕອນກ່ອນໜ້ານີ້
document_id = 'YOUR_DOCUMENT_ID'

status_url = f'https://developer.doctranslate.io/v2/document/{document_id}'
download_url = f'https://developer.doctranslate.io/v2/document/{document_id}/download'

headers = {
    'Authorization': f'Bearer {api_key}'
}

# Poll ສໍາລັບສະຖານະການແປ
while True:
    status_response = requests.get(status_url, headers=headers)
    status = status_response.json().get('status')
    print(f'ສະຖານະປັດຈຸບັນ: {status}')
    
    if status == 'done':
        print('ການແປສຳເລັດແລ້ວ. ກຳລັງດາວໂຫຼດໄຟລ໌...')
        # ດາວໂຫລດໄຟລ໌ທີ່ຖືກແປແລ້ວ
        download_response = requests.get(download_url, headers=headers)
        
        with open('translated_document.txt', 'wb') as f:
            f.write(download_response.content)
        print('ດາວໂຫຼດໄຟລ໌ສຳເລັດແລ້ວ.')
        break
    elif status == 'error':
        print('ເກີດຂໍ້ຜິດພາດໃນລະຫວ່າງການແປ.')
        break
        
    time.sleep(5) # ລໍຖ້າ 5 ວິນາທີກ່ອນທີ່ຈະກວດສອບອີກຄັ້ງ
ຂໍ້ພິຈາລະນາທີ່ສໍາຄັນສໍາລັບການແປພາສາອີຕາລີ
ນອກເໜືອໄປຈາກການເຊື່ອມໂຍງທາງດ້ານເຕັກນິກ, ການທ້ອງຖິ່ນທີ່ປະສົບຜົນສຳເລັດຮຽກຮ້ອງໃຫ້ມີຄວາມເຂົ້າໃຈສະເພາະດ້ານພາສາສາດ. ພາສາອີຕາລີມີລັກສະນະຫຼາຍຢ່າງທີ່ນັກພັດທະນາຄວນຮູ້. 
ຂໍ້ພິຈາລະນາເຫຼົ່ານີ້ຮັບປະກັນວ່າຜົນໄດ້ຮັບສຸດທ້າຍຈະຮູ້ສຶກເປັນທໍາມະຊາດ. ພວກມັນຍັງຊ່ວຍປ້ອງກັນຂໍ້ຜິດພາດທົ່ວໄປຂອງການທ້ອງຖິ່ນ.
“ເຈົ້າ” ແບບທາງການ ທຽບກັບ ແບບບໍ່ເປັນທາງການ
ພາສາອີຕາລີມີສອງຮູບແບບສໍາລັບຄໍານາມ “you”: `tu` (ແບບບໍ່ເປັນທາງການ) ແລະ `Lei` (ແບບທາງການ). ຄວາມແຕກຕ່າງນີ້ມີຜົນກະທົບຕໍ່ການຜັນຄໍາກິລິຍາ ແລະພາກສ່ວນອື່ນໆຂອງການປາກເວົ້າ. 
ການໃຊ້ຮູບແບບທີ່ຜິດພາດສາມາດເຮັດໃຫ້ສຽງຂອງແອັບພລິເຄຊັນຂອງທ່ານເບິ່ງຄືວ່າບໍ່ເໝາະສົມ. ມັນອາດຈະເປັນແບບທໍາມະດາເກີນໄປສໍາລັບເຄື່ອງມືທຸລະກິດ ຫຼືແຂງກະດ້າງເກີນໄປສໍາລັບແອັບຯສັງຄົມ.
ເມື່ອກະກຽມຂໍ້ຄວາມພາສາອັງກິດຕົ້ນສະບັບຂອງທ່ານ, ໃຫ້ພິຈາລະນາບໍລິບົດ. ທ່ານອາດຈະຕ້ອງສ້າງສະຕຣິງສະບັບທີ່ແຕກຕ່າງກັນສໍາລັບລະດັບຄວາມເປັນທາງການທີ່ແຕກຕ່າງກັນ. 
ໃນຂະນະທີ່ API ແປຂໍ້ຄວາມທີ່ສະໜອງໃຫ້, ການກໍານົດສຽງທີ່ຕ້ອງການລ່ວງໜ້າແມ່ນສ່ວນສໍາຄັນຂອງຍຸດທະສາດການທ້ອງຖິ່ນສໍາລັບຜູ້ຊົມຊາວອີຕາລີ.
ເພດ ແລະ ຂໍ້ຕົກລົງ
ໃນພາສາອີຕາລີ, ຄໍານາມມີເພດໄວຍາກອນ (ເພດຊາຍ ຫຼື ເພດຍິງ). ຄໍາຄຸນນາມແລະຄໍາ article ຕ້ອງຕົກລົງເຫັນດີກັບເພດຂອງຄໍານາມທີ່ພວກມັນດັດແປງ. 
ອັນນີ້ເຮັດໃຫ້ເກີດສິ່ງທ້າທາຍສໍາລັບການໂຕ້ຕອບຂອງຜູ້ໃຊ້ແບບໄດນາມິກ. ຕົວຢ່າງ, ສະຕຣິງເຊັ່ນ “You have a new message” ແມ່ນງ່າຍດາຍໃນພາສາອັງກິດ.
ໃນພາສາອີຕາລີ, ຄໍາສັບສໍາລັບ “new” ຈະຕ້ອງປ່ຽນແປງໂດຍອີງໃສ່ເພດຂອງ “message” (`un nuovo messaggio`). ເມື່ອສ້າງສະຕຣິງແບບໄດນາມິກຈາກຊິ້ນສ່ວນ, ອັນນີ້ສາມາດນໍາໄປສູ່ຂໍ້ຜິດພາດທາງໄວຍາກອນ. 
ມັນມັກຈະດີກວ່າທີ່ຈະແປປະໂຫຍກທີ່ສົມບູນ. ອັນນີ້ຊ່ວຍໃຫ້ເຄື່ອງຈັກແປພາສາຈັດການຂໍ້ຕົກລົງເຫຼົ່ານີ້ຢ່າງຖືກຕ້ອງໂດຍອີງໃສ່ບໍລິບົດເຕັມ.
ການຈັດການ Placeholders ແລະ Variables
ນັກພັດທະນາມັກໃຊ້ placeholders ເຊັ່ນ `{username}` ຫຼື `%d` ໃນສະຕຣິງຂອງພວກເຂົາ. ລໍາດັບຄໍາສັບໃນພາສາອີຕາລີສາມາດມີຄວາມຍືດຫຍຸ່ນຫຼາຍຂຶ້ນ ຫຼືແຕກຕ່າງຈາກພາສາອັງກິດ. 
ວະລີເຊັ່ນ `