ស្ទ្រីមព្រឹត្តិការណ៍

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

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

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

Last-Event-IDheaderstringស្រេចចិត្ត

id: នៃព្រឹត្តិការណ៍ចុងក្រោយដែលអ្នកបានទទួល។ វាមានអាទិភាពលើ cursor និង start។

cursorquerystringស្រេចចិត្ត

កន្លែងបន្ត៖ next_cursor នៃទំព័រមុន ឬ id: នៃព្រឹត្តិការណ៍ស្ទ្រីម។ ទស្សន៍ទ្រនិចចាស់ជាង 30 ថ្ងៃ ត្រូវឆ្លើយដោយ 410 ជាមួយកូដ cursor_expired។

startquerystringស្រេចចិត្ត

កន្លែងចាប់ផ្តើមដោយគ្មានទស្សន៍ទ្រនិច៖ latest សម្រាប់ព្រឹត្តិការណ៍ចាប់ពីពេលនេះ ឬ oldest សម្រាប់ព្រឹត្តិការណ៍ទាំងអស់ដែលនៅរក្សាទុក។

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

តែប្រភេទព្រឹត្តិការណ៍ទាំងនេះ បំបែកដោយសញ្ញាក្បៀស។ បើគ្មាន គឺគ្រប់ប្រភេទដែលវិសាលភាពនៃថូខឹនរបស់អ្នកអាចអានបាន។

ការឆ្លើយតប

200 ព្រឹត្តិការណ៍នៅពេលវាកើតឡើង រហូតដល់ done ឬ error

ព្រឹត្តិការណ៍ស្ទ្រីម text/event-stream

ផ្ញើមតិ keepalive រៀងរាល់ 15 វិនាទី។

event EventEnvelope

idstringចាំបាច់

typestringចាំបាច់

created_atstringចាំបាច់

api_versionstringចាំបាច់

subjectstringចាំបាច់

dataobjectចាំបាច់

done Done បញ្ចប់ស្ទ្រីម

error StreamError បញ្ចប់ស្ទ្រីម

មកដល់ក្នុងចម្លើយ 200។ បន្ទាត់ស្ថានភាពត្រូវបានផ្ញើរួចហើយ ដូច្នេះការបរាជ័យបន្ទាប់ពីស្ទ្រីមបើក ត្រូវបានរាយការណ៍ជាព្រឹត្តិការណ៍នេះ។

codestringចាំបាច់

messagestringចាំបាច់

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

កំហុស

410application/json

api_version_discontinued៖ កំណែ API នៃសំណើនេះត្រូវបានបញ្ឈប់។ cursor_expired៖ ទស្សន៍ទ្រនិចចាស់ជាង 30 ថ្ងៃ។ ចាប់ផ្តើមម្តងទៀតដោយគ្មានវា។

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 -N "https://api.getlingara.com/v1/events/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

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

ឧទាហរណ៍ស្ទ្រីម

id: djEuNzQ0MTIuOTkxLjE3OTAyNDk1NjQ
event: event
data: {"id":"lgr_evt_4f2a9c1e7b3d4e5f8a9b0c1d2e3f4a5b","type":"lesson_plan.ready","created_at":"2026-10-01T09:12:44Z","api_version":"2026-09-equipped-boxfish","subject":"lgr_sub_0f1e2d3c4b5a69788796a5b4c3d2e1f0","data":{"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"complete","title":"At the night market","source_lang":"en","target_lang":"zh","level":2}}

id: djEuNzQ0MzAuMC4xNzkwMjUwNDY0
event: done
data: {}