幫玩家簽發權杖

參數

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

想用程式庫？睇吓程式庫部分。