Convertica API

Почему Convertica API

Быстрый старт

1. Выпустите ключ в панели управления

Перейдите в панель управления API-ключами и создайте именованный ключ. Полный ключ отображается один раз — скопируйте его сразу.

2. Выполните запрос

пример curl — конвертировать PDF в Word:

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -o output.docx

Пример на Python

import requests
r = requests.post(
    "https://convertica.net/api/v1/pdf-to-word/",
    headers={"Authorization": "Bearer cvk_live_xxxxxxxxxxxxxxxx"},
    files={"pdf_file": open("input.pdf", "rb")},
)
with open("output.docx", "wb") as f:
    f.write(r.content)

Пример на Node.js

import fs from "node:fs";
import { request } from "undici";
const form = new FormData();
form.set("pdf_file", new Blob([fs.readFileSync("input.pdf")]), "input.pdf");
const r = await request("https://convertica.net/api/v1/pdf-to-word/", {
  method: "POST",
  headers: { Authorization: "Bearer cvk_live_xxxxxxxxxxxxxxxx" },
  body: form,
});
fs.writeFileSync("output.docx", Buffer.from(await r.body.arrayBuffer()));

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

Отправляйте ваш API-ключ как Bearer-токен в заголовке Authorization. Ключи привязаны к вашей подписке — отзывайте и меняйте их в любое время из панели управления.

• До 10 активных ключей на аккаунт с опциональной именованной областью
• Префикс отображается в панели управления для легкой идентификации (полный ключ показывается только при создании)
• Ежемесячная квота на ключ привязана к тарифу подписки — счетчик сбрасывается 1-го числа
• Хранится в хешированном виде; если ключ утек, отзовите его и выпустите новый за секунды

Асинхронные вебхуки

Крупные задачи возвращают ID задачи и выполняются в фоне. Либо опрашивайте эндпоинт задачи, либо укажите URL обратного вызова, и Convertica отправит результат.

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "callback_url=https://yourapp.example/convertica-hook"

Полезные данные вебхуков подписываются с помощью HMAC-SHA256, используя секрет, показанный в вашей панели управления. Проверяйте заголовок X-Convertica-Signature перед доверием к телу запроса.

Лимиты и ограничение скорости

Что вы получаете

• 30+ конечных точек конвертации: PDF↔Word, Excel, PPT, JPG, PNG, HTML, EPUB, Markdown
• Редактирование PDF: объединение, разделение, поворот, водяной знак, подпись, сжатие, обрезка, выравнивание
• Изображения: оптимизация, конвертация, HEIC→JPG/PNG
• Синхронный (малые файлы) и асинхронный (большие файлы) режимы
• Опциональные обратные вызовы вебхуков с HMAC-подписью для асинхронных результатов
• Документация OpenAPI 3
• Медиана менее 200 мс, серверы в ЕС
• Тот же бэкенд, что и convertica.net — проверено в бою

Часто задаваемые вопросы