API ແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາສະເປນ | ຮັກສາໂຄງຮ່າງເດີມ

ຄວາມທ້າທາຍຂອງການແປເອກະສານແບບໂປຣແກຣມ

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

ໜຶ່ງໃນອຸປະສັກທຳອິດແມ່ນການວິເຄາະໄຟລ໌ແລະການເຂົ້າລະຫັດຕົວອັກສອນ, ເຊິ່ງມີຄວາມສຳຄັນເປັນພິເສດເມື່ອຈັດການກັບພາສາສະເປນ. ເອກະສານປະເພດຕ່າງໆເຊັ່ນ DOCX, PDF, ແລະ PPTX ມີໂຄງສ້າງພາຍໃນທີ່ເປັນເອກະລັກ ເຊິ່ງຕ້ອງຖືກຕີຄວາມໝາຍຢ່າງຖືກຕ້ອງເພື່ອສະກັດເນື້ອຫາໂດຍບໍ່ສູນເສຍບໍລິບົດ.
ນອກຈາກນີ້, ພາສາສະເປນຍັງໃຊ້ຕົວອັກສອນພິເສດເຊັ່ນ ñ, á, é, í, ó, ແລະ ú, ແລະຖ້າການເຂົ້າລະຫັດບໍ່ໄດ້ຮັບການຈັດການຢ່າງສົມບູນ (ຕົວຢ່າງ, ໃຊ້ UTF-8), ຕົວອັກສອນເຫຼົ່ານີ້ອາດຈະຜິດພ້ຽນ.
ການເສຍຫາຍນີ້ສາມາດເຮັດໃຫ້ເອກະສານບໍ່ສາມາດອ່ານໄດ້ແລະບໍ່ເປັນມືອາຊີບ, ເຊິ່ງທຳລາຍຄຸນຄ່າຂອງບໍລິການແປພາສາທີ່ທ່ານກຳລັງພະຍາຍາມສະໜອງໃຫ້ແກ່ຜູ້ໃຊ້ສຸດທ້າຍຂອງທ່ານທັນທີ.

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

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

ຂໍແນະນຳ API ແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາສະເປນຂອງ Doctranslate

Doctranslate API ແມ່ນ REST API ທີ່ມີປະສິດທິພາບເຊິ່ງຖືກອອກແບບມາໂດຍສະເພາະເພື່ອແກ້ໄຂຄວາມທ້າທາຍທີ່ຊັບຊ້ອນເຫຼົ່ານີ້ສຳລັບນັກພັດທະນາ. ມັນສະໜອງການແກ້ໄຂແບບໂປຣແກຣມສຳລັບການແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາສະເປນທີ່ມີຄວາມเที่ยงตรงສູງ, ກ້າວໄປໄກກວ່າສາຍຂໍ້ຄວາມທຳມະດາເພື່ອຈັດການກັບໄຟລ໌ທັງໝົດ.
ໂດຍການແຍກຄວາມສັບຊ້ອນຂອງການວິເຄາະໄຟລ໌, ການສ້າງໂຄງຮ່າງຄືນໃໝ່, ແລະຄວາມແຕກຕ່າງທາງພາສາ, API ຂອງພວກເຮົາຊ່ວຍໃຫ້ທ່ານສາມາດເຊື່ອມໂຍງຄວາມສາມາດໃນການແປທີ່ຊັບຊ້ອນໄດ້ດ້ວຍລະຫັດພຽງບໍ່ເທົ່າໃດແຖວ.
ຂະບວນການທັງໝົດຖືກຈັດການຢູ່ຝັ່ງເຊີບເວີ, ແລະ API ຈະສົ່ງຄືນເອກະສານທີ່ຖືກແປຢ່າງສົມບູນແລະຈັດຮູບແບບຢ່າງສົມບູນພ້ອມສຳລັບຜູ້ໃຊ້ຂອງທ່ານ.

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

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

ຂັ້ນຕອນການເຮັດວຽກສໍາລັບການໃຊ້ Doctranslate API ແມ່ນງ່າຍດາຍແລະປະຕິບັດຕາມຫຼັກການ REST ມາດຕະຖານ. ທ່ານເລີ່ມຕົ້ນໂດຍການຮ້ອງຂໍທີ່ປອດໄພແລະໄດ້ຮັບການຢືນຢັນໄປຍັງຈຸດສິ້ນສຸດຂອງພວກເຮົາ, ສົ່ງເອກະສານເປັນສ່ວນໜຶ່ງຂອງ payload multipart/form-data.
API ປະມວນຜົນໄຟລ໌ແບບບໍ່ đồng bộ, ເຊິ່ງເໝາະສົມສຳລັບການຈັດການເອກະສານຂະໜາດໃຫຍ່ໂດຍບໍ່ກີດຂວາງ thread ຫຼັກຂອງແອັບພລິເຄຊັນຂອງທ່ານ.
ເມື່ອການແປສຳເລັດແລ້ວ, ທ່ານສາມາດດາວໂຫຼດໄຟລ໌ຜົນລັບ, ເຊິ່ງຈະມີຮູບແບບດຽວກັນກັບຕົ້ນສະບັບ ແຕ່ມີເນື້ອຫາທີ່ຖືກແປເປັນພາສາສະເປນຢ່າງສົມບູນ.

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

ການເລີ່ມຕົ້ນກັບ Doctranslate API ແມ່ນໄວແລະງ່າຍດາຍ, ຕ້ອງການພຽງເງື່ອນໄຂເບື້ອງຕົ້ນບາງຢ່າງເພື່ອເລີ່ມແປເອກະສານ. ກ່ອນທີ່ທ່ານຈະຂຽນລະຫັດໃດໆ, ທ່ານຈະຕ້ອງຕິດຕັ້ງ Python ໃນລະບົບຂອງທ່ານພ້ອມກັບไลบรารี `requests` ທີ່ນິຍົມສຳລັບການຮ້ອງຂໍ HTTP.
ສິ່ງສຳຄັນທີ່ສຸດ, ທ່ານຈະຕ້ອງມີ khóa API ຂອງ Doctranslate, ເຊິ່ງທ່ານສາມາດໄດ້ຮັບໂດຍການລົງທະບຽນໃນພໍທັນນັກພັດທະນາຂອງພວກເຮົາ.
khóa API ຂອງທ່ານຢືນຢັນການຮ້ອງຂໍຂອງທ່ານແລະຄວນຖືກເກັບຮັກສາໄວ້ຢ່າງປອດໄພ, ບໍ່ຄວນເປີດເຜີຍໃນລະຫັດฝั่งไคลเอ็นต์.

ການຢືນຢັນຕົວຕົນຖືກຈັດການຜ່ານຫົວຂໍ້ HTTP ທີ່ກຳນົດເອງໃນການຮ້ອງຂໍ API ຂອງທ່ານ. ທ່ານພຽງແຕ່ຕ້ອງການລວມ khóa API ທີ່ເປັນເອກະລັກຂອງທ່ານໃນຫົວຂໍ້ `X-API-Key` ກັບທຸກໆການໂທທີ່ທ່ານເຮັດໄປຍັງຈຸດສິ້ນສຸດຂອງພວກເຮົາ.
ວິທີການທີ່ງ່າຍດາຍແຕ່ປອດໄພນີ້ຮັບປະກັນວ່າພຽງແຕ່ແອັບພລິເຄຊັນທີ່ໄດ້ຮັບອະນຸຍາດເທົ່ານັ້ນທີ່ສາມາດເຂົ້າເຖິງບໍລິການແປພາສາໄດ້.
ພວກເຮົາແນະນຳໃຫ້ເກັບ khóa API ຂອງທ່ານເປັນຕົວແປສະພາບແວດລ້ອມໃນແອັບພລິເຄຊັນຂອງທ່ານແທນທີ່ຈະ hardcode ມັນໂດຍກົງໃນໄຟລ໌ຕົ້ນສະບັບຂອງທ່ານເພື່ອການປະຕິບັດຄວາມປອດໄພທີ່ດີກວ່າ.

ຂັ້ນຕອນທີ 1: ການອັບໂຫລດເອກະສານຂອງທ່ານເພື່ອການແປ

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

ລະຫັດ Python ຕໍ່ໄປນີ້ສະແດງວິທີການສ້າງແລະສົ່ງຄຳຮ້ອງຂໍນີ້. ມັນເປີດໄຟລ໌ທ້ອງຖິ່ນໃນໂໝດໄບນາຣີ, ກະກຽມຫົວຂໍ້ດ້ວຍ khóa API ຂອງທ່ານ, ແລະສົ່ງຂໍ້ມູນໄປຍັງຈຸດສິ້ນສຸດ API.
ຄຳຮ້ອງຂໍທີ່ສຳເລັດຈະສົ່ງຄືນວັດຖຸ JSON ທີ່ມີ `document_id` ທີ່ເປັນເອກະລັກ, ເຊິ່ງທ່ານຈະໃຊ້ໃນຂັ້ນຕອນຕໍ່ໄປເພື່ອตรวจสอบສະຖານະການແປແລະດາວໂຫລດໄຟລ໌ສຸດທ້າຍ.
ການຈັດການຂໍ້ຜິດພາດທີ່ເໝາະສົມຖືກລວມເຂົ້າໄວ້ເພື່ອຈັບບັນຫາທີ່ອາດເກີດຂຶ້ນເຊັ່ນ ໄຟລ໌ທີ່ຂາດຫາຍໄປຫຼືການຕອບສະໜອງ HTTP ທີ່ບໍ່ແມ່ນ 200 ຈາກເຊີບເວີ.


import requests
import os

# khóa API ລັບຂອງທ່ານຈາກພໍທັນນັກພັດທະນາ Doctranslate
API_KEY = "ໃສ່_API_KEY_ຂອງທ່ານ_ທີ່ນີ້"
# ເສັ້ນທາງເຕັມຂອງເອກະສານທີ່ທ່ານຕ້ອງການແປ
FILE_PATH = "ເສັ້ນທາງ/ໄປຫາ/ເອກະສານ_ພາສາອັງກິດ_ຂອງທ່ານ.docx"
# ກຳນົດລະຫັດພາສາຕົ້ນທາງແລະປາຍທາງ
SOURCE_LANG = "en"
TARGET_LANG = "es"

# ຈຸດສິ້ນສຸດ API ຂອງ Doctranslate ສໍາລັບການส่งເອກະສານ
url = "https://developer.doctranslate.io/api/v3/documents"

headers = {
    "X-API-Key": API_KEY
}

data = {
    "source_lang": SOURCE_LANG,
    "target_lang": TARGET_LANG,
}

try:
    # ເປີດໄຟລ໌ໃນໂໝດອ່ານແບບໄບນາຣີ
    with open(FILE_PATH, "rb") as f:
        files = { "file": (os.path.basename(FILE_PATH), f) }
        
        # ສົ່ງຄຳຮ້ອງຂໍ POST ໄປຍັງ API
        response = requests.post(url, headers=headers, data=data, files=files)

        # ຍົກຂໍ້ຍົກເວັ້ນສໍາລັບລະຫັດສະຖານະທີ່ບໍ່ດີ (4xx ຫຼື 5xx)
        response.raise_for_status()

        # ພິມການຕອບສະໜອງທີ່ສຳເລັດຈາກເຊີບເວີ
        print("ອັບໂຫລດເອກະສານເພື່ອການແປສຳເລັດແລ້ວ!")
        print(response.json())

except requests.exceptions.HTTPError as err:
    print(f"ຂໍ້ຜິດພາດ HTTP: {err}")
except FileNotFoundError:
    print(f"ຂໍ້ຜິດພາດ: ບໍ່ພົບໄຟລ໌ທີ່ {FILE_PATH}")
except Exception as e:
    print(f"ເກີດຂໍ້ຜິດພາດທີ່ບໍ່ຄາດຄິດ: {e}")

ຂັ້ນຕອນທີ 2: ການຈັດການການຕອບສະໜອງຂອງ API

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

ຂະບວນການແປເປັນແບບບໍ່ đồng bộ, ໝາຍຄວາມວ່າມັນເຮັດວຽກຢູ່ເບື້ອງຫຼັງໃນເຊີບເວີຂອງພວກເຮົາ. ການອອກແບບນີ້ມີຄວາມສຳຄັນສຳລັບການຈັດການເອກະສານຂະໜາດໃຫຍ່ຫຼືซับซ้อนໂດຍບໍ່ບັງຄັບໃຫ້ແອັບພລິເຄຊັນຂອງທ່ານຕ້ອງລໍຖ້າການຮ້ອງຂໍ HTTP ທີ່ໃຊ້ເວລາດົນໃຫ້ສຳເລັດ.
ການຕອບສະໜອງເບື້ອງຕົ້ນໂດຍປົກກະຕິຈະສະແດງສະຖານະ `queued` ຫຼື `processing`, ເຊິ່ງຊີ້ບອກວ່າວຽກກຳລັງດຳເນີນຢູ່.
ໂລຈິກຂອງແອັບພລິເຄຊັນຂອງທ່ານຄວນຖືກອອກແບບມາເພື່ອຈັດການກັບຂັ້ນຕອນການເຮັດວຽກແບບບໍ່ đồng bộ ນີ້, ໂດຍການ polling ຈຸດສິ້ນສຸດສະຖານະຫຼືໂດຍການໃຊ້ webhooks ສໍາລັບການແຈ້ງເຕືອນ.

ຂັ້ນຕອນທີ 3: ການດາວໂຫລດເອກະສານທີ່ແປແລ້ວ

ເມື່ອທ່ານມີ `document_id` ແລ້ວ, ທ່ານສາມາດตรวจสอบສະຖານະຂອງວຽກການແປເປັນໄລຍະໆ. ນີ້ເຮັດໄດ້ໂດຍການຮ້ອງຂໍ `GET` ໄປຍັງຈຸດສິ້ນສຸດ `/v3/documents/{document_id}`, ບ່ອນທີ່ `{document_id}` ແມ່ນ ID ທີ່ທ່ານໄດ້ຮັບໃນຂັ້ນຕອນກ່ອນໜ້ານີ້.
ຈຸດສິ້ນສຸດນີ້ຈະສົ່ງຄືນວັດຖຸ JSON ທີ່ມີ `status` ປັດຈຸບັນ, ເຊິ່ງສາມາດເປັນ `queued`, `processing`, `completed`, ຫຼື `error`.
ແອັບພລິເຄຊັນຂອງທ່ານຄວນ poll ຈຸດສິ້ນສຸດນີ້ໃນໄລຍະເວລາທີ່ເໝາະສົມ, ເຊັ່ນ ທຸກໆ 10-15 ວິນາທີ, ຈົນກວ່າສະຖານະຈະປ່ຽນເປັນ `completed`.

ເມື່ອສະຖານະເປັນ `completed`, ເອກະສານທີ່ແປແລ້ວແມ່ນພ້ອມໃຫ້ດາວໂຫລດ. ທ່ານສາມາດດຶງໄຟລ໌ໄດ້ໂດຍການຮ້ອງຂໍ `GET` ອີກຄັ້ງ, ຄັ້ງນີ້ໄປທີ່ຈຸດສິ້ນສຸດ `/v3/documents/{document_id}/result`.
ຈຸດສິ້ນສຸດນີ້ຈະສົ່ງຄືນຂໍ້ມູນໄບນາຣີດິບຂອງໄຟລ໌ທີ່ແປແລ້ວ, ເຊິ່ງທ່ານສາມາດບັນທຶກໄວ້ໃນເຄື່ອງທ້ອງຖິ່ນໄດ້.
ສະຄຣິບ Python ຕໍ່ໄປນີ້ສະແດງ vòng lặp polling ງ່າຍໆທີ່ตรวจสอบສະຖານະ ແລະ, ເມື່ອສຳເລັດ, ຈະດາວໂຫລດແລະບັນທຶກເອກະສານພາສາສະເປນ.


import requests
import time

# khóa API ລັບຂອງທ່ານ
API_KEY = "ໃສ່_API_KEY_ຂອງທ່ານ_ທີ່ນີ້"
# ID ຈາກການຕອບສະໜອງການອັບໂຫລດເບື້ອງຕົ້ນ
DOCUMENT_ID = "ID_ເອກະສານ_ຂອງທ່ານ_ຈາກ_ຂັ້ນຕອນ_ທີ_1"

# ກຳນົດຈຸດສິ້ນສຸດ API ສໍາລັບการตรวจสอบສະຖານະແລະການດາວໂຫລດ
status_url = f"https://developer.doctranslate.io/api/v3/documents/{DOCUMENT_ID}"
download_url = f"https://developer.doctranslate.io/api/v3/documents/{DOCUMENT_ID}/result"

headers = {
    "X-API-Key": API_KEY
}

# Poll ສະຖານະການແປຈົນກວ່າມັນຈະສຳເລັດຫຼືເກີດຂໍ້ຜິດພາດ
while True:
    try:
        response = requests.get(status_url, headers=headers)
        response.raise_for_status()
        status_data = response.json()
        status = status_data.get("status")

        print(f"ສະຖານະເອກະສານປັດຈຸບັນ: {status}")

        if status == "completed":
            print("ການແປສຳເລັດ! ເລີ່ມດາວໂຫລດ...")
            # ຖ້າສຳເລັດ, ດາວໂຫລດໄຟລ໌ທີ່ແປແລ້ວ
            download_response = requests.get(download_url, headers=headers)
            download_response.raise_for_status()

            with open("translated_document_es.docx", "wb") as f:
                f.write(download_response.content)

            print("ດາວໂຫລດໄຟລ໌ສຳເລັດເປັນ translated_document_es.docx")
            break
        elif status == "error":
            print(f"ເກີດຂໍ້ຜິດພາດໃນລະຫວ່າງການແປ: {status_data.get('error_message')}")
            break
        
        # ລໍຖ້າ 10 ວິນາທີກ່ອນตรวจสอบສະຖານະອີກຄັ້ງ
        print("ກຳລັງລໍຖ້າ 10 ວິນາທີກ່ອນการตรวจสอบຄັ້ງຕໍ່ໄປ...")
        time.sleep(10)

    except requests.exceptions.HTTPError as err:
        print(f"ຂໍ້ຜິດພາດ HTTP: {err}")
        break
    except Exception as e:
        print(f"ເກີດຂໍ້ຜິດພາດທີ່ບໍ່ຄາດຄິດ: {e}")
        break

ຂໍ້ຄວນພິຈາລະນາຫຼັກເມື່ອຈັດການກັບລາຍລະອຽດສະເພາະຂອງພາສາສະເປນ

ເມື່ອແປຈາກພາສາອັງກິດເປັນພາສາສະເປນ, ມີລາຍລະອຽດທາງພາສາຫຼາຍຢ່າງທີ່ຕ້ອງພິຈາລະນາຢ່າງລະມັດລະວັງເພື່ອຮັບປະກັນຜົນລັບທີ່ມີຄຸນນະພາບສູງ. ໄວຍາກອນພາສາສະເປນປະກອບມີຄຳນາມແລະຄຳຄຸນນາມທີ່ມີເພດ, ໝາຍຄວາມວ່າວັດຖຸເປັນเพศชายຫຼືเพศหญิง, ແລະຄຳຄຸນນາມຕ້ອງสอดคล้องกับพวกมัน.
ນອກຈາກນີ້, ພາສານີ້ຍັງມີວິທີການເວົ້າກັບຄົນແບບທາງການ (`usted`) ແລະບໍ່ເປັນທາງການ (`tú`), ແລະການເລືອກທີ່ຖືກຕ້ອງຂຶ້ນຢູ່ກັບບໍລິບົດແລະຜູ້ຊົມຢ່າງຫຼວງຫຼາຍ.
ໃນຂະນະທີ່ແບບຈຳລອງຂັ້ນສູງຂອງ API ຂອງພວກເຮົາໄດ້ຮັບການຝຶກອົບຮົມເພື່ອຈັດການກັບຄວາມซับซ้อนເຫຼົ່ານີ້, ນັກພັດທະນາຄວນຮັບຮູ້ວ່າເນື້ອຫາທີ່เฉพาะเจาะจงสูงຫຼືດ້ານเทคนิคອາດຈະໄດ້ຮັບປະໂຫຍດຈາກການກວດສອບໂດຍມະນຸດຄັ້ງສຸດທ້າຍເພື່ອຄວາມถูกต้องຂອງນ້ຳສຽງທີ່ສົມບູນແບບ.

ອີກປັດໄຈໜຶ່ງທີ່ສຳຄັນແມ່ນການມີພາສາສະເປນຖິ່ນຈຳນວນຫຼາຍທົ່ວໂລກ, ຕັ້ງແຕ່ພາສາສະເປນ Castilian ໃນປະເທດສະເປນໄປຈົນເຖິງຮູບແບບຕ່າງໆຂອງພາສາສະເປນລາຕິນອາເມລິກາ. ແຕ່ລະພາກພື້ນມີຄຳສັບ, ສຳນວນ, ແລະການອ້າງອີງທາງວັດທະນະທຳຂອງຕົນເອງ.
Doctranslate API ໃຊ້ພາສາສະເປນທີ່ເປັນກາງ, ເປັນສາກົນທີ່ຜູ້ເວົ້າພາສາສະເປນທຸກຄົນເຂົ້າໃຈຢ່າງກວ້າງຂວາງ, ເຊິ່ງເປັນພື້ນຖານທີ່ດີເລີດສຳລັບຜູ້ຊົມທຸກກຸ່ມ.
ສຳລັບແອັບພລິເຄຊັນທີ່ແນໃສ່ພາກພື້ນທີ່เฉพาะเจาะจงมาก, ທ່ານສາມາດໃຊ້ຜົນລັບຂອງ API ເປັນພື້ນຖານที่มั่นคงแล้วจึงนำຂັ້ນຕອນການแก้ไขหลังการแปลมาใช้เพื่อสลับคำศัพท์ท้องถิ่นเมื่อจำเป็น, ຊ່ວຍປະຢັດເວລາແລະຄວາມພະຍາຍາມໄດ້ຢ່າງຫຼວງຫຼາຍ.

ບາງທີຂໍ້ພິຈາລະນາທາງເທັກນິກທີ່ສຳຄັນທີ່ສຸດສຳລັບນັກພັດທະນາແມ່ນການຂະຫຍາຍຕົວຂອງຂໍ້ຄວາມ. ຂໍ້ຄວາມພາສາສະເປນໂດຍປົກກະຕິແລ້ວຈະຍາວກວ່າພາສາອັງກິດທີ່ທຽບເທົ່າປະມານ 15-25%, ເປັນປະກົດການທີ່ສາມາດສ້າງຄວາມເສຍຫາຍໃຫ້ກັບໂຄງຮ່າງເອກະສານທີ່ອອກແບບມາຢ່າງລະມັດລະວັງ.
ການຂະຫຍາຍຕົວນີ້ສາມາດເຮັດໃຫ້ຂໍ້ຄວາມລົ້ນອອກຈາກຕາຕະລາງ, ກ່ອງຂໍ້ຄວາມ, ແລະຄໍລຳ, ນຳໄປສູ່ຮູບລັກສະນະທີ່ແຕກຫັກແລະບໍ່ເປັນມືອາຊີບ.
ນີ້ຄືຈຸດທີ່ Doctranslate API ເກັ່ງແທ້; ເຄື່ອງຈັກຮັກສາໂຄງຮ່າງຂອງມັນຈະປັບຮູບແບບໂດຍອັດຕະໂນມັດ, ຈັດเรียงຂໍ້ຄວາມໃໝ່ແລະປັບຂະໜາດອົງປະກອບເພື່ອຮອງຮັບເນື້ອຫາພາສາສະເປນທີ່ຍາວກວ່າ ໃນຂະນະທີ່ຍັງຮັກສາຄວາມສົມບູນຂອງການອອກແບບເດີມຂອງເອກະສານ.

ສະຫຼຸບ: ຂັ້ນຕອນຕໍ່ໄປຂອງທ່ານສຳລັບການແປທີ່ສົມບູນແບບ

ສະຫຼຸບແລ້ວ, ໃນຂະນະທີ່ການແປເອກະສານແບບໂປຣແກຣມຈາກພາສາອັງກິດເປັນພາສາສະເປນມີຄວາມທ້າທາຍທີ່ສຳຄັນທີ່ກ່ຽວຂ້ອງກັບການວິເຄາະໄຟລ໌, ການຮັກສາໂຄງຮ່າງ, ແລະຄວາມຊັບຊ້ອນທາງພາສາ, ອຸປະສັກເຫຼົ່ານີ້ບໍ່ແມ່ນສິ່ງທີ່ບໍ່ສາມາດເອົາຊະນະໄດ້. ໂດຍການໃຊ້ບໍລິການສະເພາະທາງ, ທ່ານສາມາດຂ້າມສ່ວນທີ່ຍາກທີ່ສຸດຂອງຂະບວນການໄດ້.
Doctranslate API ສະໜອງການແກ້ໄຂທີ່ແຂງແກ່ນ, ເປັນມິດກັບນັກພັດທະນາ ທີ່ອອກແບບມາເພື່ອຜະລິດການແປທີ່ມີຄວາມเที่ยงตรงສູງເຊິ່ງເຄົາລົບການຈັດຮູບແບບຂອງເອກະສານຕົ້ນສະບັບ.
ສິ່ງນີ້ຊ່ວຍໃຫ້ທ່ານສາມາດສຸມໃສ່ໂລຈິກຫຼັກຂອງແອັບພລິເຄຊັນຂອງທ່ານແທນທີ່ຈະເປັນຄວາມซับซ้อนของวิศวกรรมเอกสารและการทำให้เป็นสากล.

ດ້ວຍຄູ່ມືນີ້, ຕອນນີ້ທ່ານມີຄວາມພ້ອມດ້ວຍຄວາມຮູ້ໃນການເຊື່ອມໂຍງຄວາມສາມາດໃນການແປເອກະສານທີ່ມີປະສິດທິພາບເຂົ້າໃນໂຄງການຂອງທ່ານ. ທ່ານສາມາດປັບປຸງຂັ້ນຕອນການເຮັດວຽກຂອງທ່ານ, ຫຼຸດຜ່ອນຄວາມພະຍາຍາມດ້ວຍມື, ແລະສົ່ງເອກະສານທີ່ແປແບບມືອາຊີບໃຫ້ກັບຜູ້ໃຊ້ຂອງທ່ານໃນນາທີ. ສໍາລັບນັກພັດທະນາທີ່ຕ້ອງການປັບປຸງຂະບວນການນີ້, ທ່ານສາມາດ ບັນລຸການແປເອກະສານທັນທີທີ່ຮັກສາຮູບແບບໄວ້ ດ້ວຍການແກ້ໄຂທີ່ມີປະສິດທິພາບແລະໃຊ້ງານງ່າຍ.
ພວກເຮົາຂໍແນະນຳໃຫ້ທ່ານລົງທະບຽນເພື່ອຮັບ khóa API ແລະສຳຫຼວດຄວາມສາມາດຂອງแพลตฟอร์มของเราด้วยเอกสารของคุณเองเพื่อดูคุณภาพด้วยตัวคุณเอง.

ເພື່ອສຶກສາລົງເລິກກ່ຽວກັບຄຸນສົມບັດຂັ້ນສູງເພີ່ມເຕີມ, ພວກເຮົາແນະນຳໃຫ້ປຶກສາເອກະສານ API ທາງການຂອງພວກເຮົາ. ທີ່ນັ້ນທ່ານຈະພົບຂໍ້ມູນທີ່ครอบคลุมในหัวข้อต่างๆ ເຊັ່ນ การใช้ webhooks ສຳລັບการแจ้งเตือนแบบไม่ đồng bộ, ການໃຊ້ศัพท์เฉพาะสำหรับคำศัพท์ที่สอดคล้องกัน, ແລະການจัดการรหัสข้อผิดพลาดต่างๆ ຢ່າງສວຍງາມ.
ເອກະສານຍັງໃຫ້ລາຍລະອຽດກ່ຽວກັບຄູ່ພາສາແລະຮູບແບບໄຟລ໌ທີ່ຮອງຮັບທັງໝົດ, ເຮັດໃຫ້ທ່ານເຫັນພາບລວມທີ່ສົມບູນຂອງຄວາມສາມາດຂອງ API.
ໂດຍການ maîtrise ເຄື່ອງມືເຫຼົ່ານີ້, ທ່ານສາມາດສ້າງແອັບພລິເຄຊັນລະດັບໂລກຢ່າງແທ້ຈິງທີ່สื่อสารอย่างมีประสิทธิภาพข้ามอุปสรรคทางภาษา.

API ແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາສະເປນ | ຮັກສາໂຄງຮ່າງເດີມ | ຄູ່ມືດ່ວນ