Справочник API

Небольшой HTTP-API поверх того же конвейера конвертации, которым пользуется сайт. Отправляете файл — получаете файл. Четыре эндпоинта, SDK не нужен.

Эндпоинты

• Конвертация файлаРаботу выполняет один эндпоинт. Отправьте файл и целевой формат — получите задачу: завершённую, если это было быстро, или поставленную в очередь, если нет.
• Опрос и скачиваниеПоставленная в очередь конвертация выдаёт идентификатор задачи. Эти два эндпоинта сообщают, когда она готова, и отдают файл.
• Каталог форматовОдин публичный эндпоинт без аутентификации возвращает всё, что мы конвертируем, и каждый маршрут между форматами. Стройте интерфейс на его основе, а не на зашитом списке.
• Ошибки и коды состоянияОшибки приходят в JSON, всегда одной формы, и всегда несут стабильный машиночитаемый код. Ветвитесь по коду, а не по сообщению.