同玩家簽發權杖

參數

Lingara-Versionheaderstring選填

回應這隻請求所用个 API 版本。無這隻个話，存取權杖會用佢个用戶端綁定个版本，無權杖个請求會用這下个版本。還在開發个版本，淨係在這位講明正用得到。無認識个版本會回 400，代碼係 api_version_unknown。GET /v1/versions 會列出所有版本。

請求內容 application/json

player_refstring必填

你自家對這隻玩家个參照：1 到 128 位元組个 UTF-8，無控制字元。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"}'

想用函式庫？請看函式庫這一節。