Terbitkan token untuk pemain

Versi API 2026-10-virile-dragon

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

Menjamin salah satu pemain Anda dan mengembalikan token yang digunakan game atau halaman Anda untuknya selama 15 menit. Token pertama untuk sebuah player_ref membuat pelajar untuk pemain itu; token berikutnya memakainya kembali. Minta lagi saat token kedaluwarsa; token tidak pernah diperbarui. Memerlukan klien metered.

Cakupan embed:mint

Parameter

Lingara-Versionheaderstringopsional: Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapatkan versi yang disematkan pada kliennya, dan permintaan tanpa token mendapatkan versi saat ini. Versi yang masih dalam pengembangan hanya dapat dicapai dengan menyebutkannya di sini. Versi yang tidak dikenal dijawab 400 dengan kode api_version_unknown. GET /v1/versions mencantumkan versi-versinya.

Isi permintaan `application/json`

player_refstringwajib: Referensi Anda sendiri untuk pemain: 1 hingga 128 byte UTF-8, tanpa karakter kontrol. Lingara hanya menyimpan hash-nya.
scopesarray of string | nullopsional
originstring | nullopsional

Respons

200 Token pemain

tokenstringwajib
expires_atstringwajib
expires_inintegerwajib: Detik hingga token kedaluwarsa, dihitung dari jawaban ini. Gunakan saat jam perangkat tidak dapat dipercaya.
subjectstringwajib
scopesarray of stringwajib
account_linkedbooleanwajib

Galat

410application/json: Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Kirim versi yang didukung di Lingara-Version, atau sematkan klien ke versi lain.
4XXapplication/json: Permintaan ditolak. code menyebutkan alasannya, dan error menjelaskannya dengan kata-kata.
503application/json · text/plain: Layanan sementara tidak tersedia; coba lagi setelah jumlah detik di Retry-After. Selama pemeliharaan, isi respons berupa teks biasa, bukan amplop galat.
5XXapplication/json: Permintaan ditolak. code menyebutkan alasannya, dan error menjelaskannya dengan kata-kata.

codestringwajib: Alasan permintaan ditolak, sebagai kode tetap untuk percabangan: misalnya insufficient_scope (403), rate_limited (429) dan, untuk klien dengan penagihan per pemakaian, 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 bagian Pustaka.