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 バージョン。指定がない場合、アクセストークンはそのクライアントに固定されたバージョンを、トークンのないリクエストは現行バージョンを受け取ります。開発中のバージョンには、ここで指定した場合にのみアクセスできます。不明なバージョンにはコード 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"

ライブラリを使いたい場合は、ライブラリのセクションをご覧ください。

翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。