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

Интегрируйте мощное преобразование файлов в свое приложение с помощью нашего RESTful API.

НачатьkeyПолучить ключ API
bolt

Молниеносно

Высокопроизводительное преобразование с оптимизированной обработкой

shield

Безопасный и надежный

Безопасность корпоративного уровня с временем безотказной работы 99,9 %.

trending_up

Масштабируемый

От прототипа до производства мы масштабируемся вместе с вами

terminalНачиная

Чтобы использовать API 1converter, выполните следующие простые шаги:

  1. Зарегистрируйте бесплатный аккаунт на 1converter.com.
  2. Сгенерируйте ключ API на своей панели управления
  3. Начните делать запросы API с помощью вашего ключа API

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

Все запросы API должны включать ваш ключ API в заголовок авторизации:

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

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

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

Базовый URL

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

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

OpenAPI 3.1 specification (JSON)

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

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

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

POST/api/v1/convert/upload

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

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

Тело запроса

  • файл для конвертации (обязательно)
  • целевой формат (например, «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 нужен платный тариф:

ПланОграничение скорости
БесплатноНедоступно — требуется платный план
Стартер5 000 запросов в минуту
Про5 000 запросов в минуту
БизнесБезлимитный

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

Коды ошибок

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

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

integration_instructionsПримеры кода

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

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, мы здесь, чтобы помочь!

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