プレイヤーを削除
API バージョン 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}
プレイヤーの1人と、そのプレイヤーが作成したすべて(プラン、イベント、有効なトークン)を削除します。再試行しても安全です。不明な player_ref も 204 を返します。
スコープ 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" \
-H "Authorization: Bearer $LINGARA_TOKEN"翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。