Hủy liên kết người chơi khỏi tài khoản Lingara của họ
Phiên bản API 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}/link
Kết thúc liên kết của một người chơi. Từ lần gọi tiếp theo, người chơi lại chơi với tư cách khách của bạn. Không có gì được chuyển về: những gì liên kết đã chuyển vẫn ở trong tài khoản của người học. Người chơi không có liên kết đang hoạt động, hoặc đã bị hủy liên kết, trả lời 404 embed_link_not_found.
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 Liên kết đã kết thúc
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/link" \
-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.