API документация

FileConvert Pro API позволяет загружать, конвертировать и получать файлы программно. Все запросы выполняются по HTTPS и возвращают ответы в формате JSON.

Аутентификация

Все запросы к API должны содержать заголовок авторизации с вашим API-ключом. Ключ можно получить в личном кабинете в разделе «API».

Authorization: Bearer fcp_live_9k2j1n4m8x7q3w5e6r0t

curl -X GET https://api.fileconvertpro.com/v1/account \
  -H "Authorization: Bearer fcp_live_9k2j1n4m8x7q3w5e6r0t"

⚠️ Не передавайте API-ключ на клиентской стороне (в браузере). Используйте его только в серверных запросах.

Базовый URL

https://api.fileconvertpro.com/v1

Загрузка файла

POST /v1/files

Загружает файл на сервер и возвращает его идентификатор для последующей конвертации. Максимальный размер файла — 500 МБ на бесплатном тарифе.

Параметры запроса

Параметр	Тип	Описание
file обязательный	binary	Содержимое файла в формате multipart/form-data
filename необязательный	string	Имя файла, если отличается от исходного

curl -X POST https://api.fileconvertpro.com/v1/files \
  -H "Authorization: Bearer fcp_live_9k2j1n4m8x7q3w5e6r0t" \
  -F "file=@document.docx"

Пример ответа

{
  "id": "file_7f3a9c1e2b",
  "filename": "document.docx",
  "size": 245678,
  "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "status": "uploaded",
  "created_at": "2026-08-27T10:14:02Z"
}

Запуск конвертации

POST /v1/convert

Запускает асинхронную конвертацию ранее загруженного файла в указанный формат.

Параметры запроса

Параметр	Тип	Описание
file_id обязательный	string	Идентификатор файла, полученный при загрузке
target_format обязательный	string	Целевой формат, например pdf, png, mp3
quality необязательный	string	Качество результата: low, medium, high

curl -X POST https://api.fileconvertpro.com/v1/convert \
  -H "Authorization: Bearer fcp_live_9k2j1n4m8x7q3w5e6r0t" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "file_7f3a9c1e2b",
    "target_format": "pdf",
    "quality": "high"
  }'

Пример ответа

{
  "task_id": "task_4e8d2a6c1f",
  "status": "processing",
  "estimated_time": 8
}

Проверка статуса задачи

GET /v1/tasks/{task_id}

Возвращает текущий статус задачи конвертации.

curl -X GET https://api.fileconvertpro.com/v1/tasks/task_4e8d2a6c1f \
  -H "Authorization: Bearer fcp_live_9k2j1n4m8x7q3w5e6r0t"

{
  "task_id": "task_4e8d2a6c1f",
  "status": "completed",
  "result_file_id": "file_9b1c4e7a2d",
  "download_url": "https://api.fileconvertpro.com/v1/files/file_9b1c4e7a2d/download"
}

Скачивание результата

GET /v1/files/{file_id}/download

Возвращает бинарное содержимое сконвертированного файла. Ссылка на скачивание действительна в течение 60 минут после завершения конвертации.

Удаление файла

DELETE /v1/files/{file_id}

Немедленно удаляет файл с серверов. Файлы также удаляются автоматически через час после загрузки.

Коды ошибок

Код	Описание
400	Некорректные параметры запроса
401	Неверный или отсутствующий API-ключ
404	Файл или задача не найдены
413	Превышен максимальный размер файла
429	Превышен лимит запросов по тарифу
500	Внутренняя ошибка сервера

Лимиты запросов

Бесплатный тариф: 60 запросов в минуту, 100 конвертаций в сутки. Для увеличения лимитов перейдите на тариф Pro или Business в разделе «Тарифы».