Cambio en API: nombres de Template pasan a slugs seguros para URL
Queremos compartir un cambio en nuestra API que aplicaremos el 30 de abril de 2020. Ese día,
cambiaremos todos los nombres que nuestros clientes les han dado a sus Templates a un formato
seguro para URL. Si, por ejemplo, tu Template antes se llamaba
Video encode for Apple Devices, el nuevo nombre será video-encode-for-apple-devices.
Este cambio hará posible empezar a referirse a los Templates por este nombre seguro para URL, al que llamamos slug. Como resultado, podrás crear tus Assemblies así:
{
"params": {
"template_id": "video-encode-for-apple-devices"
}
}
en lugar de hacerlo solo por su ID, como antes:
{
"params": {
"template_id": "a528022861cf4a0292ea96bd2b18efc1"
}
}
Esto hace que las Assembly Instructions sean más autoexplicativas dentro de tu editor de
código, y puede ayudar a evitar errores que pasan desapercibidos con facilidad al usar UUIDv4 sin
guiones, como a528022861cf4a0292ea96bd2b18efc1. Además, tenemos en preparación una función, todavía
secreta, que se beneficiará mucho de poder referirse a los Templates por su slug.
¡Mantente atento!
Por supuesto, como con cualquier cambio, hay una contrapartida: si empiezas a adoptar los slugs de Template, eso significa que no podrás cambiar ese nombre (léase: slug) sin romper tus integraciones. Conviene hacerlo con cuidado o, si esto resulta problemático para tu caso de uso, seguir usando los Template IDs como ya lo haces. No hace falta ningún cambio.
¿Convertir los nombres en slugs es retrocompatible?
No esperamos que la migración rompa nada, ya que, hasta ese momento, los nombres de
Template legibles por humanos (Video encode for Apple Devices) solo deberían haberlos usado,
bueno, humanos. Transloadit no ofrece ninguna funcionalidad basada en estos nombres, más allá de
mostrarlos en listas y permitir que las personas los busquen. Esto seguirá funcionando después de
la migración. Escribe: apple, y obtendrás video-encode-for-apple-devices, igual que habrías obtenido
Video encode for Apple Devices en tus resultados de búsqueda.
Lo único que podría romperse es si, en tu propio código de automatización, dependes de alguna manera de los nombres de Template. Si es tu caso, te recomendamos cambiarlo antes del 30 de abril de 2020 para evitar cualquier problema. Lo mejor es no depender de los nombres en absoluto y usar los IDs en tu propio código si quieres asegurarte de que todo funcione para siempre.