Keluarkan token untuk pemain

Versi API 2026-10-virile-dragon

post https://api.getlingara.com/v1/embed/tokens

Menjamin salah seorang pemain anda dan memulangkan token yang digunakan oleh permainan atau halaman anda untuknya selama 15 minit. Token pertama untuk sesuatu player_ref mencipta pelajar untuk pemain itu; token seterusnya menggunakannya semula. Minta lagi apabila token tamat tempoh; ia tidak pernah diperbaharui. Memerlukan klien metered.

Skop embed:mint

Parameter

Lingara-Versionheaderstringpilihan: Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapat versi yang dipautkan kepada kliennya, dan permintaan tanpa token mendapat versi semasa. Versi yang masih dalam pembangunan hanya boleh dicapai dengan menamakannya di sini. Versi yang tidak dikenali dijawab 400 dengan kod api_version_unknown. GET /v1/versions menyenaraikan versi.

Kandungan permintaan `application/json`

player_refstringwajib: Rujukan anda sendiri untuk pemain: 1 hingga 128 bait UTF-8, tanpa aksara kawalan. Lingara hanya menyimpan cincangannya.
scopesarray of string | nullpilihan
originstring | nullpilihan

Respons

200 Token pemain

tokenstringwajib
expires_atstringwajib
expires_inintegerwajib: Saat sehingga token tamat tempoh, dikira dari jawapan ini. Gunakannya apabila jam peranti tidak boleh dipercayai.
subjectstringwajib
scopesarray of stringwajib
account_linkedbooleanwajib

Ralat

410application/json: Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Hantar versi yang disokong dalam Lingara-Version, atau pautkan klien kepada versi lain.
4XXapplication/json: Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.
503application/json · text/plain: Perkhidmatan tidak tersedia buat sementara waktu; cuba lagi selepas bilangan saat dalam Retry-After. Semasa penyelenggaraan, kandungan ialah teks biasa dan bukan sampul ralat.
5XXapplication/json: Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

codestringwajib: Sebab permintaan ditolak, sebagai kod stabil untuk dijadikan asas percabangan: contohnya insufficient_scope (403), rate_limited (429) dan, bagi klien bermeter, spend_cap_reached (402) dan metered_billing_inactive (402).
errorstringwajib

Contoh

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"}'

Lebih suka pustaka? Lihat bahagian Pustaka.