/api/v6/urlshortener/links/{domain}/{code}Eliminar un enlace corto
El enlace deja de redirigir y desaparece de la API. Su código queda ocupado, y lo puedes restaurar durante 90 días.
Alcance y límites
API key con el servicio urlshortener habilitado y la capacidad urlshortener.write concedida
35 solicitudes por segundo
Borrado lógico: el enlace deja de redirigir de inmediato (el visitante recibe 404) y desaparece de todas las respuestas de la API, estadísticas incluidas. Lo cobrado se conserva, y queda registrado quién lo eliminó. Su código queda ocupado para siempre en ese dominio: nadie puede crear otro enlace con él, pero tú puedes restaurar este, sin nuevo cobro, durante 90 días. Después el enlace se archiva con sus visitas y ya no se puede restaurar; el código sigue ocupado.
Un enlace bloqueado por Hablame (status: blocked) no se puede eliminar: responde 409 LINK_BLOCKED.
Pide una key que pueda escribir
Además del servicio urlshortener, la API key necesita la capacidad urlshortener.write, y solo la concede un propietario o un administrador de tu organización al crear la key. Sin ella, la key lista y consulta enlaces, estadísticas, el resumen, los dominios y la tarifa, y aquí recibe 403 AUTH_CAPABILITY_NOT_ALLOWED.
Parámetros de ruta
domaindomain. Se compara en minúsculas. Nombra al enlace que hoy responde en esa URL corta; para uno de un dominio que ya no es de tu organización (domainStatus: released), añade domainStatus=released.codeParámetros de consulta
domainStatusreleased, el enlace es el de un dominio que ya no es de tu organización (el que la lista devuelve con domainStatus: released), aunque ese nombre sea hoy el de otro dominio con el mismo código. Sin él, domain nombra al dominio que hoy se llama así. Otro valor responde 400 VALIDATION_INVALID_PARAMETER.releasedRespuestas
Enlace eliminado. La respuesta no trae cuerpo.
Credenciales inválidas o faltantes.
La API key no tiene habilitado el acortador (o está apagado para tu organización), no tiene la capacidad urlshortener.write para crear y editar enlaces, no se puede usar desde la red de la petición, o la organización no está activa.
No existe un enlace de tu organización con ese dominio y código, o ya estaba eliminado.
El enlace está bloqueado por Hablame.
Se excedió el límite de solicitudes.
Errores posibles
Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.
AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.403AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403AUTH_IP_NOT_ALLOWEDLa key solo funciona desde ciertas redes y tu IP no está entre ellas.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.403AUTH_CAPABILITY_NOT_ALLOWEDLa key tiene el servicio, pero no la capacidad que exige este endpoint.404LINK_NOT_FOUNDNo hay un enlace con ese dominio y código.409LINK_BLOCKEDEl enlace está bloqueado por seguridad.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.