ចាប់ផ្តើមរហ័ស

កំណែ API 2026-10-affable-towhee

ប្រាំជំហានពីគ្មានអ្វីសោះ រហូតដល់បញ្ជីវាក្យសព្ទដែលផ្សាយជាស្ទ្រីម៖ បង្កើតក្លាយអិនត៍ ដាក់វាក្នុង shell របស់អ្នក ប្ដូរវាដើម្បីទទួលបានថូខឹនចូលប្រើ ធ្វើការហៅមួយ ហើយទទួលបានថូខឹនថ្មីនៅពេលវាផុតកំណត់។

1. បង្កើតក្លាយអិនត៍

នៅលើទំព័រ ការតភ្ជាប់ នៃកម្មវិធីគេហទំព័រ Lingara តាម app.getlingara.com/admin នៅក្រោម ក្លាយអិនត៍ OAuth សូមបង្កើតក្លាយអិនត៍ដែលអាច បង្កើតវាក្យសព្ទ (វិសាលភាព vocab:generate)។ ចម្លង ID ក្លាយអិនត៍ និងសម្ងាត់របស់វា។ សម្ងាត់បង្ហាញតែម្តងគត់។

2. ដាក់វាក្នុង shell របស់អ្នក

រក្សាទុក ID ក្លាយអិនត៍ និងសម្ងាត់ ក្នុងអថេរបរិស្ថាន LINGARA_CLIENT_ID និង LINGARA_CLIENT_SECRET ដូច្នេះគ្មានសម្ងាត់ណាត្រូវបានសរសេរចូលក្នុងពាក្យបញ្ជាឡើយ។

export LINGARA_CLIENT_ID="<your client id>"
export LINGARA_CLIENT_SECRET="<your client secret>"

3. ទទួលបានថូខឹនចូលប្រើ

ពាក្យបញ្ជានេះប្ដូរក្លាយអិនត៍ដើម្បីទទួលបានថូខឹនចូលប្រើ ហើយរក្សាទុកវាក្នុង LINGARA_TOKEN ដែលឧទាហរណ៍នីមួយៗក្នុងឯកសារយោងនេះអានពីទីនោះ។ វាត្រូវការ jq និង curl 7.76 ឬថ្មីជាងនេះ។ បើការប្ដូរបរាជ័យ ពាក្យបញ្ជាបង្ហាញកូដកំហុស (ឧទាហរណ៍ invalid_client៖ សូមពិនិត្យ ID និងសម្ងាត់) ហើយទុក LINGARA_TOKEN ទទេ ដូច្នេះការហៅបន្ទាប់បរាជ័យដោយ 401 រហូតដល់ការប្ដូរជោគជ័យ។ បើគ្មាន jq សូមដំណើរការការប្ដូរពីមគ្គុទ្ទេសក៍ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ ហើយចម្លង access_token ពីការឆ្លើយតបដោយដៃ។

export LINGARA_TOKEN="$(curl -sS --fail-with-body -X POST "https://api.getlingara.com/oauth/token" \
  -u "$LINGARA_CLIENT_ID:$LINGARA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  --data-urlencode "scope=vocab:generate" | jq -r '.access_token // error(.error)')"

4. បង្កើតបញ្ជីវាក្យសព្ទ

ដំណើរការពាក្យបញ្ជានេះ។ -N បិទការផ្ទុកបណ្តោះអាសន្នរបស់ curl ដូច្នេះព្រឹត្តិការណ៍នីមួយៗបង្ហាញភ្លាមៗពេលវាមកដល់។

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

អ្វីដែលអ្នកគួរឃើញ

ព្រឹត្តិការណ៍ started ជាមួយព័ត៌មានលម្អិតនៃបញ្ជី ព្រឹត្តិការណ៍ item មួយសម្រាប់ពាក្យនីមួយៗ បន្ទាប់មក done។ ពាក្យរបស់អ្នកនឹងខុសពីឧទាហរណ៍នេះ។

event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}

event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好，我叫小明。","translation":"Hello, my name is Xiaoming."}}

event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}

event: done
data: {}

5. នៅពេលផុតមួយម៉ោង

ការហៅឆ្លើយតប 401។ សូមដំណើរការជំហានទី 3 ម្តងទៀត។ បើជំហានទី 3 ឥឡូវបរាជ័យ នោះក្លាយអិនត៍ ឬសម្ងាត់របស់វាបានផ្លាស់ប្តូរនៅលើទំព័រ ការតភ្ជាប់។ កម្មវិធីមួយធ្វើតាមច្បាប់នៃមគ្គុទ្ទេសក៍ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ៖ ប្ដូរម្តងទៀតមួយដងសម្រាប់ 401 នីមួយៗ ហើយឈប់បើការប្ដូរបរាជ័យ។

ប្រសិនបើការបកប្រែ និងឯកសារយោងជាភាសាអង់គ្លេសខុសគ្នា ឯកសារយោងជាភាសាអង់គ្លេសគឺជាឯកសារដែលត្រឹមត្រូវ។