Hapus pemain
Versi API 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}
Menghapus salah satu pemain Anda beserta semua yang mereka buat: rencana, peristiwa, dan token aktif mereka. Aman untuk dicoba ulang: player_ref yang tidak dikenal juga menjawab 204.
Cakupan embed:mint
Parameter
Lingara-Versionheaderstringopsional- Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapatkan versi yang disematkan pada kliennya, dan permintaan tanpa token mendapatkan versi saat ini. Versi yang masih dalam pengembangan hanya dapat dicapai dengan menyebutkannya di sini. Versi yang tidak dikenal dijawab
400dengan kodeapi_version_unknown.GET /v1/versionsmencantumkan versi-versinya. player_refpathstringwajibplayer_refyang Anda gunakan untuk menerbitkan token pemain, dalam pengodean persen:guild/42menjadiguild%2F42.
Respons
204 Pemain sudah dihapus
Galat
410application/json- Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Kirim versi yang didukung di
Lingara-Version, atau sematkan klien ke versi lain. 4XXapplication/json- Permintaan ditolak.
codemenyebutkan alasannya, danerrormenjelaskannya dengan kata-kata. 503application/json · text/plain- Layanan sementara tidak tersedia; coba lagi setelah jumlah detik di
Retry-After. Selama pemeliharaan, isi respons berupa teks biasa, bukan amplop galat. 5XXapplication/json- Permintaan ditolak.
codemenyebutkan alasannya, danerrormenjelaskannya dengan kata-kata.
codestringwajibAlasan permintaan ditolak, sebagai kode tetap untuk percabangan: misalnya
insufficient_scope(403),rate_limited(429) dan, untuk klien dengan penagihan per pemakaian,spend_cap_reached(402) danmetered_billing_inactive(402).errorstringwajib
Contoh
curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF" \
-H "Authorization: Bearer $LINGARA_TOKEN"Jika terjemahan berbeda dengan referensi berbahasa Inggris, referensi berbahasa Inggris yang berlaku.