Mudança na API: nomes de Template viram slugs seguros para URL
Gostaríamos de compartilhar uma mudança na nossa API que faremos em 30 de abril de 2020. Nesse dia,
vamos converter todos os nomes que nossos clientes deram aos seus Templates para um formato
seguro para URL. Se, por exemplo, seu Template se chamava
Video encode for Apple Devices, o novo nome será video-encode-for-apple-devices.
Essa mudança permitirá referenciar Templates por esse nome seguro para URL, que chamamos de slug. Com isso, você poderá criar suas Assemblies assim:
{
"params": {
"template_id": "video-encode-for-apple-devices"
}
}
em vez de referenciá-los apenas pelo ID, como antes:
{
"params": {
"template_id": "a528022861cf4a0292ea96bd2b18efc1"
}
}
Isso deixa as Assembly Instructions mais autoexplicativas direto no seu editor de código e
pode ajudar a evitar erros que passam facilmente despercebidos ao usar UUIDv4 sem hífens, como
a528022861cf4a0292ea96bd2b18efc1. Também temos em desenvolvimento um recurso, ainda secreto, que vai
se beneficiar muito da possibilidade de referenciar Templates pelo slug. Fique de olho!
Claro que, como em qualquer mudança, há uma contrapartida: se você começar a adotar slugs de Template, não poderá mudar esse nome (leia-se: slug) sem quebrar suas integrações. Isso deve ser feito com cuidado ou, se for um problema para o seu caso de uso, basta continuar referenciando os Template IDs como você já faz. Nenhuma mudança é necessária.
A conversão de nomes em slugs é retrocompatível?
Não esperamos nenhuma quebra com a migração, já que, até esse momento, os nomes legíveis de
Template (Video encode for Apple Devices) deveriam ter sido usados apenas por, bem,
humanos. A Transloadit não oferece nenhuma funcionalidade baseada nesses nomes, além de exibi-los
em listas e permitir que humanos façam buscas por eles. Isso continuará funcionando após a
migração. Digite apple e você obterá video-encode-for-apple-devices, assim
como teria obtido Video encode for Apple Devices nos resultados da busca.
A única coisa que poderia quebrar é se, no seu próprio código de automação, você depender de alguma forma dos nomes de Template. Se esse for o seu caso, recomendamos mudar isso antes de 30 de abril de 2020 para evitar qualquer quebra. O melhor é não depender de nomes de forma alguma e usar IDs no seu próprio código, se quiser garantir que tudo continue funcionando para sempre.