ចេញថូខឹនសម្រាប់អ្នកលេង

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

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

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

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

player_refstringចាំបាច់

សេចក្ដីយោងផ្ទាល់ខ្លួនរបស់អ្នកសម្រាប់អ្នកលេង៖ UTF-8 ពី 1 ដល់ 128 បៃ ដោយគ្មានតួអក្សរបញ្ជា។ Lingara រក្សាទុកតែហាសរបស់វាប៉ុណ្ណោះ។

scopesarray of string | nullស្រេចចិត្ត

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

ការឆ្លើយតប

200 ថូខឹនរបស់អ្នកលេង

tokenstringចាំបាច់

expires_atstringចាំបាច់

expires_inintegerចាំបាច់

ចំនួនវិនាទីរហូតដល់ថូខឹនផុតកំណត់ គិតពីចម្លើយនេះ។ ប្រើវានៅពេលមិនអាចទុកចិត្តនាឡិការបស់ឧបករណ៍បាន។

subjectstringចាំបាច់

scopesarray of stringចាំបាច់

account_linkedbooleanចាំបាច់

កំហុស

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/embed/tokens" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"player_ref":"player-1001","scopes":["embed:play","lesson_plans:read","lesson_plans:write"],"origin":"https://game.example.com"}'

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