形式カタログ
認証不要の公開エンドポイントがひとつあり、当方が変換するすべてと形式間のすべての経路を返します。一覧をコードに直接書き込まず、これを基にインターフェースを組み立ててください。
キーは不要です
GET https://rework.live/api/v1/formats に認証は不要です。これはデータではなく機能の一覧であり、サービスが何を変換するのかを知るためだけにキーを要求するのは、ささやかな不親切です。加えて、支払い前に API を評価できないことにもなってしまいます。
レスポンスは 1 時間キャッシュできます。リクエストごとではなく、起動時に取得してください。
curl https://rework.live/api/v1/formats返るもの
2 つの配列です。formats は読み書きできる各形式を説明し、conversions はそれらを結ぶすべての辺です。
{
"formats": [
{
"id": "png",
"label": "PNG",
"kind": "image",
"extensions": ["png"],
"mime": "image/png"
}
],
"conversions": [
{
"from": "png",
"to": "webp",
"fidelity": "high",
"async": false,
"maxInputMb": 200,
"options": []
}
]
}| フィールド | 説明 |
|---|---|
| from / to | この辺が結ぶ形式 ID |
| fidelity | 変換の忠実度 |
| async | この変換が即時実行ではなくキューに入る場合は真 |
| maxInputMb | この変換が受け入れる最大の入力サイズ |
| options | この変換が受け付ける追加パラメータ(ある場合) |
上限はひとつではなく 2 つです
maxInputMb はその変換固有の上限です。プランにも別の上限があり、実際に適用されるのは小さいほうです。Plus アカウントであっても、変換自体がそれ未満しか受け付けないなら 400 MB の動画は失敗します。