API de eliminación de enlaces

Elimina enlaces cortos de forma permanente.

Una vez eliminado, el enlace no se puede recuperar y el acceso se bloquea de inmediato.
Asegúrate de que ya no esté en uso antes de eliminarlo.

Para enlaces críticos, considera usar enlaces personalizados (ID propio) que puedan recrearse si es necesario.

Utiliza esta API para eliminar enlaces innecesarios o restringir el acceso.

DELETE

/api/link/v1/delete?linkId={linkId}&domain={domain}


DELETE /api/link/v1/delete
        ?linkId=4Rt3
        &domain=https%3A%2F%2Fvvd.bz

Request Parameters

linkId string required
ID del enlace.
Si la URL es “https://vvd.bz/fML”, el ID del enlace es fML.
domain string required
Default:https://vvd.bz
Dominio del enlace.
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
Código de respuesta: 0 = Éxito, otros valores = Error
message string
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
result null

Cuándo usar esta API

Utiliza la API de eliminación en situaciones como estas:

  • Limpiar enlaces de eventos o campañas finalizadas
  • Eliminar enlaces creados por error
  • Desactivar de inmediato enlaces que ya no deben estar accesibles por motivos de seguridad
  • Mantener tu cuenta organizada eliminando enlaces innecesarios
Los enlaces eliminados se desactivan al instante y dejan de funcionar, incluso si ya fueron compartidos.
Si solo necesitas cambiar la URL de destino, utiliza la API de actualización (Update API).

Diferencias con la API de actualización

La API de eliminación elimina el enlace por completo, mientras que la API de actualización lo modifica.

  • Eliminar: El enlace se borra de forma permanente. Al acceder, se muestra una página de error y no puede recuperarse.
  • Actualizar: El enlace se mantiene activo y solo se cambian la URL de destino o la configuración. Los enlaces compartidos siguen funcionando.

Impacto de la eliminación

Eliminar un enlace tiene los siguientes efectos:

  • El enlace corto se desactiva de inmediato
  • Al acceder, se mostrará un error o no se cargará ninguna página
  • El acceso a las estadísticas asociadas puede verse limitado
  • Todos los enlaces compartidos dejan de funcionar
La eliminación es irreversible, por lo que debe realizarse con precaución.

Aspectos a tener en cuenta

La eliminación es definitiva—revisa estos puntos antes de continuar.

  • Verifica que linkId y domain sean correctos
  • Los enlaces eliminados no se pueden recuperar
  • Para enlaces críticos, usa brandLinkId para crear IDs personalizados que puedas recrear
  • Evalúa el impacto antes de realizar eliminaciones masivas
En producción, limita los permisos de eliminación para evitar pérdidas accidentales.