Bir oyuncu için token oluşturma

API sürümü 2026-10-virile-dragon

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

Oyuncularınızdan birine kefil olur ve oyununuzun veya sayfanızın onun için 15 dakika kullanacağı bir token döndürür. Bir player_ref için ilk token o oyuncu için bir öğrenci oluşturur; sonrakiler onu yeniden kullanır. Token süresi dolduğunda yenisini isteyin; hiçbir zaman yenilenmez. metered bir istemci gerektirir.

Kapsamlar embed:mint

Parametreler

Lingara-Versionheaderstringisteğe bağlı: Bu isteğin yanıtlanacağı API sürümü. Belirtilmezse bir erişim token'ı istemcisinin bağlı olduğu sürümü, token içermeyen bir istek ise güncel sürümü alır. Hâlâ geliştirilmekte olan sürüme yalnızca burada adı verilerek ulaşılır. Bilinmeyen bir sürüm 400 ve api_version_unknown koduyla yanıtlanır. GET /v1/versions sürümleri listeler.

İstek gövdesi `application/json`

player_refstringzorunlu: Oyuncu için kendi referansınız: kontrol karakteri içermeyen 1 ila 128 baytlık UTF-8. Lingara bunun yalnızca bir hash değerini saklar.
scopesarray of string | nullisteğe bağlı
originstring | nullisteğe bağlı

Yanıtlar

200 Oyuncunun tokenı

tokenstringzorunlu
expires_atstringzorunlu
expires_inintegerzorunlu: Bu yanıttan itibaren tokenın süresinin dolmasına kalan saniye. Cihazın saatine güvenilemediğinde bunu kullanın.
subjectstringzorunlu
scopesarray of stringzorunlu
account_linkedbooleanzorunlu

Hatalar

410application/json: Bu isteğin yanıtlandığı API sürümü sonlandırıldı. Lingara-Version içinde desteklenen bir sürüm gönderin veya istemciyi başka bir sürüme bağlayın.
4XXapplication/json: İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.
503application/json · text/plain: Hizmet geçici olarak kullanılamıyor; Retry-After içindeki saniye sayısı kadar bekledikten sonra yeniden deneyin. Bakım sırasında gövde, hata zarfı yerine düz metindir.
5XXapplication/json: İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.

codestringzorunlu: İsteğin neden reddedildiği, dallanmak için kullanılabilecek sabit bir kod olarak: örneğin insufficient_scope (403), rate_limited (429) ve kullanım başına ücretlendirilen bir istemci için spend_cap_reached (402) ile metered_billing_inactive (402).
errorstringzorunlu

Örnek

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

Kütüphane mi tercih edersiniz? Kütüphaneler bölümüne bakın.