プレイヤーと 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 バージョン。指定がない場合、アクセストークンはそのクライアントに固定されたバージョンを、トークンのないリクエストは現行バージョンを受け取ります。開発中のバージョンには、ここで指定した場合にのみアクセスできます。不明なバージョンにはコード
api_version_unknownとともに400を返します。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"翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。