API 更新:Template 名を URL セーフなスラッグに変更
2020年4月30日に実施する API の変更についてお知らせします。当日は、お客様が
Templateに付けたすべての名前を、URL セーフな形式に変更します。たとえば、これまで
Templateの名前が
Video encode for Apple Devices だった場合、新しい名前は
video-encode-for-apple-devices になります。

この変更により、スラッグと呼ばれる URL セーフな名前で Templateを参照できるようになります。その結果、次のようにAssemblyを作成できます。
{
"params": {
"template_id": "video-encode-for-apple-devices"
}
}
これまでは、次のように ID でしか参照できませんでした。
{
"params": {
"template_id": "a528022861cf4a0292ea96bd2b18efc1"
}
}
これにより、コードエディター内でAssembly Instructionsの内容を理解しやすくなります。また、a528022861cf4a0292ea96bd2b18efc1 のようなダッシュなしの UUIDv4 を使う際に見落としがちなミスの防止にも役立ちます。さらに、まだ秘密ですが、Templateをスラッグで参照できることが大いに役立つ機能も開発中です。どうぞお楽しみに。
もちろん、どのような変更にも利点と制約があります。Templateのスラッグを使い始めると、その名前(つまりスラッグ)を変更した場合、既存の連携が動作しなくなります。名前の変更は慎重に行う必要があります。これが用途上の問題になる場合は、これまでどおりTemplate IDで参照し続けてください。変更は不要です。
名前をスラッグに変換しても後方互換性は保たれるか?
移行によって不具合が生じるとは考えていません。それまでは、人が読みやすい
Template名(Video encode for Apple Devices)は、あくまで人が使うためだけのものだったはずだからです。Transloadit では、名前を一覧に表示し、人がその名前で検索する機能以外に、名前に基づく機能は提供していません。これらの機能は移行後も引き続き利用できます。apple と入力すると、移行後は検索結果に
video-encode-for-apple-devices が表示されます。これは、これまで
Video encode for Apple Devices が表示されていたのと同じです。
不具合が生じる可能性があるのは、独自の自動化コードで何らかの形で Template名に依存している場合だけです。該当する場合は、不具合を避けるために2020年4月30日より前にコードを変更することをお勧めします。将来にわたって確実に動作させたい場合は、名前には一切依存せず、コード内では代わりに ID を使うのが最善です.
