Xóa người chơi
Phiên bản API 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}
Xóa một người chơi của bạn và mọi thứ họ đã tạo: kế hoạch, sự kiện và các token còn hiệu lực. Có thể thử lại an toàn: một player_ref không xác định cũng trả về 204.
Phạm vi embed:mint
Tham số
Lingara-Versionheaderstringtùy chọn- Phiên bản API dùng để trả lời yêu cầu này. Nếu không có, token truy cập nhận phiên bản mà ứng dụng khách của nó được gắn, còn yêu cầu không có token nhận phiên bản hiện tại. Phiên bản đang phát triển chỉ có thể dùng bằng cách nêu tên nó ở đây. Phiên bản không xác định được trả lời bằng
400với mãapi_version_unknown.GET /v1/versionsliệt kê các phiên bản. player_refpathstringbắt buộcplayer_refbạn đã dùng để cấp token cho người chơi, được mã hóa phần trăm:guild/42thànhguild%2F42.
Phản hồi
204 Người chơi đã bị xóa
Lỗi
410application/json- Phiên bản API dùng để trả lời yêu cầu này đã bị ngừng. Hãy gửi một phiên bản được hỗ trợ trong
Lingara-Version, hoặc gắn ứng dụng khách với một phiên bản khác. 4XXapplication/json- Yêu cầu đã bị từ chối.
codecho biết lý do, vàerrordiễn đạt lý do đó bằng lời. 503application/json · text/plain- Dịch vụ tạm thời không khả dụng; hãy thử lại sau số giây ghi trong
Retry-After. Trong thời gian bảo trì, phần thân là văn bản thuần thay vì phong bì lỗi. 5XXapplication/json- Yêu cầu đã bị từ chối.
codecho biết lý do, vàerrordiễn đạt lý do đó bằng lời.
codestringbắt buộcLý do yêu cầu bị từ chối, dưới dạng một mã ổn định để rẽ nhánh: ví dụ
insufficient_scope(403),rate_limited(429) và, với ứng dụng khách tính phí theo mức dùng,spend_cap_reached(402) vàmetered_billing_inactive(402).errorstringbắt buộc
Ví dụ
curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF" \
-H "Authorization: Bearer $LINGARA_TOKEN"Nếu bản dịch và tài liệu tham chiếu tiếng Anh khác nhau, tài liệu tham chiếu tiếng Anh là bản đúng.