Desvincular un jugador de su cuenta de Lingara

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

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

Termina el vínculo de un jugador. Desde la siguiente llamada el jugador vuelve a jugar como tu invitado. Nada regresa: lo que el vínculo trasladó se queda en la cuenta del estudiante. Un jugador sin vínculo activo, o ya desvinculado, responde 404 embed_link_not_found.

Á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 vínculo ha terminado

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/link" \
  -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.