ផ្ញើព្រឹត្តិការណ៍

ប៉ារ៉ាម៉ែត្រ

Lingara-Versionheaderstringស្រេចចិត្ត

កំណែ API ដែលត្រូវប្រើឆ្លើយសំណើនេះ។ បើគ្មានវាទេ token ចូលប្រើទទួលបានកំណែដែលម៉ាស៊ីនភ្ញៀវរបស់វាត្រូវបានភ្ជាប់ ហើយសំណើដែលគ្មាន token ទទួលបានកំណែបច្ចុប្បន្ន។ កំណែដែលកំពុងអភិវឌ្ឍអាចចូលដល់បានតែដោយដាក់ឈ្មោះវានៅទីនេះប៉ុណ្ណោះ។ កំណែដែលមិនស្គាល់ឆ្លើយតប 400 ជាមួយកូដ api_version_unknown។ GET /v1/versions បង្ហាញបញ្ជីកំណែ។

Idempotency-Keyheaderstringចាំបាច់

តម្លៃដែលអ្នកជ្រើសសម្រាប់ព្រឹត្តិការណ៍នីមួយៗ ហើយប្រើម្តងទៀតពេលព្យាយាមឡើងវិញ៖ តួអក្សរ ASCII ដែលមើលឃើញពី 1 ដល់ 255 ដូចជា UUID។ ការព្យាយាមឡើងវិញដោយប្រើកូនសោដដែលនឹងទទួលបានចម្លើយដំបូងវិញ ហើយមិនត្រូវគិតប្រាក់ម្តងទៀតទេ ទោះបីខ្លឹមសារខុសគ្នាក៏ដោយ។ បើគ្មានកូនសោត្រឹមត្រូវ សំណើនឹងឆ្លើយតប 400 ជាមួយកូដ idempotency_key_required។

ខ្លឹមសារសំណើ application/json

typestringចាំបាច់

dataWorldPracticeRequestedចាំបាច់

topicstringចាំបាច់

source_langstringចាំបាច់

target_langstringចាំបាច់

levelintegerចាំបាច់

tagsarray of stringស្រេចចិត្ត

generateboolean | nullស្រេចចិត្ត

ការឆ្លើយតប

202 ព្រឹត្តិការណ៍ត្រូវបានកត់ត្រា

idstringចាំបាច់

typestringចាំបាច់

created_atstringចាំបាច់

reactionReactionReport | nullស្រេចចិត្ត

statusReactionStatusចាំបាច់

plan_idstring | nullស្រេចចិត្ត

plan_statusPlanStatus | nullស្រេចចិត្ត

ស្ថានភាពរបស់ផែនការ នៅពេលព្រឹត្តិការណ៍ត្រូវបានទទួល។ មានតែ generating ទេដែលសន្យាថា lesson_plan.ready ឬ lesson_plan.failed នឹងមកដល់។ តម្លៃផ្សេងទៀតគឺជាផែនការពីបណ្ណាល័យ ដែលអ្នកអាចអានឥឡូវនេះដោយប្រើ GET /v1/lesson-plans/{id}។

codestring | nullស្រេចចិត្ត

errorstring | nullស្រេចចិត្ត

កំហុស

402application/json

ការហៅរបស់ក្លាយអិនត៍ដែលគិតថ្លៃតាមការប្រើប្រាស់ត្រូវបានបដិសេធ មុនពេលវាចំណាយអ្វីទាំងអស់។ spend_cap_reached៖ ក្លាយអិនត៍ ឬគណនីរបស់វាបានដល់កម្រិតចំណាយប្រចាំខែរបស់វាហើយ សូមដំឡើងកម្រិតនៅលើទំព័រ ការតភ្ជាប់។ metered_billing_inactive៖ ការគិតថ្លៃតាមការប្រើប្រាស់មិនទាន់សកម្មសម្រាប់គណនីនេះទេ សូមរៀបចំវា ឬធ្វើបច្ចុប្បន្នភាពវិធីបង់ប្រាក់ នៅលើទំព័រ ការតភ្ជាប់។

410application/json

កំណែ API ដែលប្រើឆ្លើយសំណើនេះត្រូវបានបញ្ឈប់ហើយ។ សូមផ្ញើកំណែដែលគាំទ្រនៅក្នុង Lingara-Version ឬភ្ជាប់ម៉ាស៊ីនភ្ញៀវទៅកំណែផ្សេង។

4XXapplication/json

សំណើត្រូវបានបដិសេធ។ code ប្រាប់មូលហេតុ ហើយ error ពន្យល់វាជាពាក្យ។

503application/json · text/plain

សេវាកម្មមិនអាចប្រើបានជាបណ្តោះអាសន្ន; សូមព្យាយាមម្តងទៀតបន្ទាប់ពីចំនួនវិនាទីក្នុង Retry-After។ ក្នុងពេលថែទាំ ខ្លឹមសារជាអត្ថបទធម្មតា មិនមែនជាស្រោមកំហុសទេ។

5XXapplication/json

សំណើត្រូវបានបដិសេធ។ code ប្រាប់មូលហេតុ ហើយ error ពន្យល់វាជាពាក្យ។

codestringចាំបាច់

មូលហេតុដែលសំណើត្រូវបានបដិសេធ ជាកូដថេរសម្រាប់បែងចែកតក្កវិជ្ជា៖ ឧទាហរណ៍ insufficient_scope (403), rate_limited (429) ហើយសម្រាប់ក្លាយអិនត៍ដែលគិតថ្លៃតាមការប្រើប្រាស់ spend_cap_reached (402) និង metered_billing_inactive (402)។

errorstringចាំបាច់

ឧទាហរណ៍

curl -X POST "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"world.context_changed","data":{"scene":"A night market in Taipei, just after rain","npc":{"name":"Auntie Lin","persona":"a street-food vendor who likes to haggle"},"source_lang":"en","target_lang":"zh","level":3,"tags":["market","food","chapter-2"],"generate":true}}'

ចូលចិត្តបណ្ណាល័យមែនទេ? សូមមើលផ្នែកបណ្ណាល័យ។