为玩家签发令牌

参数

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

更喜欢用库？请参阅“库”部分。