Resuelva colisiones de slug con un sufijo numérico

Si el valor está disponible, lo devuelve sin cambios. Si ya existe, prueba alternativas numéricas como -2, -3 y las siguientes hasta encontrar la primera libre. Es un componente pequeño y determinista para sistemas de publicación, importaciones, generadores de documentación y cualquier flujo que deba asignar una ruta URL única sin sustituir contenido existente por accidente.

Conserve el slug deseado siempre que sea posible

Un buen solucionador de colisiones solo debe modificar una URL cuando sea necesario. Envíe el valor propuesto en desired_slug e incluya todos los valores ocupados en used_slugs. La comparación es exacta y distingue mayúsculas de minúsculas. Si la propuesta no aparece en el conjunto ocupado, el resultado contiene el slug original e indica que no hubo colisión. La herramienta no convierte a minúsculas, no recorta, no translitera ni sustituye signos: esas transformaciones corresponden a una etapa previa de creación del slug. Separar ambas responsabilidades evita cambios inesperados en las URL y permite reproducir el resultado en compilaciones, migraciones y pruebas. Un slug deseado vacío se rechaza, pues convertirlo en un sufijo arbitrario ocultaría un título ausente o un mapeo anterior defectuoso. Las entradas duplicadas de la lista no alteran la respuesta; la consulta las consolida de forma natural, así que usted no necesita depurarlas para obtener un resultado estable.

Elija el primer sufijo numérico disponible

Cuando el slug exacto está ocupado, la selección empieza en 2, de acuerdo con la convención habitual: la ruta sin sufijo representa el primer elemento y el siguiente recibe -2. Después se comprueban los candidatos en orden ascendente: deseado-2, deseado-3, deseado-4 y así sucesivamente. El proceso se detiene ante el primer candidato ausente de la lista. Por eso los huecos se reutilizan de manera previsible. Si report, report-2 y report-4 están ocupados, por ejemplo, el resultado será report-3. Se comparan cadenas completas, de modo que annual-report o report-old no generan una colisión. Una terminación numérica existente se considera parte literal del valor y no se interpreta ni reescribe: si usted solicita release-2 y ya existe, el primer candidato será release-2-2. Este comportamiento evita adivinar intenciones y garantiza que las mismas entradas siempre produzcan la misma salida, sin depender de bases de datos, relojes, números aleatorios, configuraciones regionales ni del orden de ejecución.

Utilice el resultado con seguridad al publicar

Esta capacidad resulta útil cuando su aplicación ya conoce los slugs reservados. Reúna esos valores, envíelos con el slug deseado y utilice el resultado para el nuevo registro. La respuesta también indica si ocurrió una colisión y, cuando añade una terminación, qué número seleccionó. Estos datos sirven para registros, vistas previas o mensajes que expliquen por qué la URL difiere de la propuesta inicial. La operación no reserva el valor devuelto; los sistemas con escrituras simultáneas deben conservar una restricción única y reintentar con una lista actualizada si otro proceso ocupa el mismo slug. En importaciones por lotes, añada cada asignación correcta al conjunto local antes de resolver la fila siguiente. Como la comparación es exacta, aplique antes y de forma coherente su propia política de URL: use un generador de slugs si necesita normalizar mayúsculas, Unicode, espacios o puntuación. Cada solicitud API cuesta $0.002, y la misma lógica determinista puede ejecutarse en el navegador para comprobaciones interactivas.