Lingara Lingara Tài liệu Cẩm nang API Thư viện Ứng dụng Tạo Nhúng Ứng dụng web
Ngôn ngữ: Tiếng Việt

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 400 với mã api_version_unknown. GET /v1/versions liệt kê các phiên bản.
player_refpathstringbắt buộc
player_ref bạn đã dùng để cấp token cho người chơi, được mã hóa phần trăm: guild/42 thành guild%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. code cho biết lý do, và error diễ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. code cho biết lý do, và error diễn đạt lý do đó bằng lời.
codestringbắt buộc

Lý 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"

Muốn dùng thư viện? Xem mục Thư viện.

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.