API リファレンス

ウェブサイトと同じ変換パイプラインの上に用意した小さな HTTP API です。ファイルを送れば、ファイルが返ります。エンドポイントは 4 つ、SDK は不要です。

エンドポイント

• ファイルを変換する処理を行うエンドポイントはひとつです。ファイルと変換先の形式を送ると、ジョブが返ります。短時間で終われば完了済み、そうでなければキュー済みです。
• 照会とダウンロードキューに入った変換はジョブ ID を返します。この 2 つのエンドポイントが、完了時期を知らせ、ファイルを渡します。
• 形式カタログ認証不要の公開エンドポイントがひとつあり、当方が変換するすべてと形式間のすべての経路を返します。一覧をコードに直接書き込まず、これを基にインターフェースを組み立ててください。
• エラーとステータスコードエラーは常に同じ形の JSON で返り、常に安定した機械可読のコードを伴います。メッセージではなくコードで分岐してください。