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

Конвертируйте файлы из своего кода: загрузите файл, проверьте статус, скачайте результат. Три запроса и один API-ключ.

Получить ключ APIНачать
curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Начиная

От нуля до первого сконвертированного файла:

  1. Выберите платный тариф (Starter, Pro или Business) на 1-converter.com. На Free API-ключей нет.
  2. Создайте ключ в разделе «Кабинет → Настройки → API-ключи» и скопируйте его: он показывается только один раз.
  3. Передайте ключ с первой загрузкой, как показано в разделе «Аутентификация».

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

Передавайте ключ API в каждом запросе в любом из двух заголовков:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Подходят оба заголовка, ключ в них один и тот же. Выбирайте тот, который удобнее вашему HTTP-клиенту.

Никому не передавайте API-ключ и не добавляйте его в систему контроля версий.

Храните свой ключ API в безопасности и никогда не раскрывайте его в коде на стороне клиента.

Базовый URL

Все запросы API следует направлять по адресу:

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

Конечные точки API

Загрузить и конвертировать

Загрузите файл и преобразуйте его в указанный формат.

POST/api/v1/convert/upload

Заголовки запросов

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Тело запроса

  • fileфайл для конвертации (обязательно)
  • target_formatцелевой формат (например, «pdf», «jpg», «png») (обязательно)

Ответ

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Проверить статус

Проверьте статус конверсии

GET/api/v1/convert/status/:id

Ответ

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Скачать результат

Загрузите конвертированный файл

GET/api/v1/convert/download/:id

Ограничения ставок

В каждый платный тариф входит месячный лимит вызовов API, тот же, что указан на странице тарифов.

ПланВызовов API в месяц
FreeБез API-ключей
Starter1 000 вызовов API в месяц
Pro10 000 вызовов API в месяц
BusinessAPI без лимита

При превышении ограничений скорости вы получите ответ 429 Too Many Requests.

Коды ошибок

API использует стандартные коды состояния HTTP для обозначения успеха или неудачи:

КодОписание
400 неверный запросНеверные параметры запроса
401 НесанкционированныйНеверный или отсутствующий ключ API.
403 ЗапрещеноНедостаточно разрешений
404 Не найденРесурс не найден
429 Слишком много запросовПревышен лимит скорости
500 Внутренняя ошибка сервераОшибка сервера, попробуйте еще раз

Примеры кода

Вот примеры на разных языках программирования:

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Питон

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

КУЛЬ

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Нужна помощь?

Запрос завершается ошибкой, которую эта документация не объясняет? Напишите нам и приложите запрос и полученный ответ.

Обратиться в службу поддержкиУправление ключами API