Eliminar un jugador

Versión de la API 2026-10-virile-dragon

delete https://api.getlingara.com/v1/embed/players/{player_ref}

Elimina a uno de tus jugadores y todo lo que creó: sus planes, sus eventos y sus tokens vigentes. Es seguro reintentarlo: un player_ref desconocido también responde 204.

Ámbitos embed:mint

Parámetros

Lingara-Versionheaderstringopcional: La versión de la API con la que se responde a esta solicitud. Sin ella, un token de acceso recibe la versión a la que está vinculado su cliente, y una solicitud sin token recibe la versión actual. La versión aún en desarrollo solo se alcanza nombrándola aquí. Una versión desconocida responde 400 con el código api_version_unknown. GET /v1/versions enumera las versiones.
player_refpathstringobligatorio: El player_ref con el que emitiste los tokens del jugador, codificado con porcentajes: guild/42 es guild%2F42.

Respuestas

204 El jugador se ha eliminado

Errores

410application/json: La versión de la API con la que se responde a esta solicitud se ha retirado. Envía una versión admitida en Lingara-Version o vincula el cliente a otra versión.
4XXapplication/json: La solicitud fue rechazada. code indica el motivo y error lo explica con palabras.
503application/json · text/plain: El servicio no está disponible temporalmente; vuelve a intentarlo tras el número de segundos indicado en Retry-After. Durante el mantenimiento, el cuerpo es texto sin formato en lugar del sobre de error.
5XXapplication/json: La solicitud fue rechazada. code indica el motivo y error lo explica con palabras.

codestringobligatorio: Por qué se rechazó la solicitud, como un código estable con el que ramificar: por ejemplo insufficient_scope (403), rate_limited (429) y, para un cliente con facturación por uso, spend_cap_reached (402) y metered_billing_inactive (402).
errorstringobligatorio

Ejemplo

curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

¿Prefieres una biblioteca? Consulta la sección Bibliotecas.

Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.