Lingara Lingara 文档 学习指南 API 库 应用 构建 嵌入 网页版
语言: 中文简体

解除玩家与其 Lingara 账户的关联

API 版本 2026-10-virile-dragon

delete https://api.getlingara.com/v1/embed/players/{player_ref}/link

结束玩家的关联。从下一次调用起,玩家将重新以你的访客身份进行游戏。不会有任何内容被移回:关联转移的内容会保留在学习者的账户中。没有有效关联或已解除关联的玩家会返回 404 embed_link_not_found。

权限范围 embed:mint

参数

Lingara-Versionheaderstring可选
回应此请求所用的 API 版本。不提供时,访问令牌使用其客户端绑定的版本,不带令牌的请求使用当前版本。仍在开发中的版本只能通过在此指定来访问。未知版本会以 400 回应,代码为 api_version_unknown。GET /v1/versions 会列出所有版本。
player_refpathstring必填
你为该玩家签发令牌时使用的 player_ref,经过百分号编码:guild/42 写作 guild%2F42。

响应

204 关联已结束

错误

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 DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

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

如译文与英文参考文档不一致,以英文参考文档为准。