API
ВойтиКабинетПолучить ключПолучить ключ
Документация

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

1. Получите ключ

Зарегистрируйтесь на smartpdf.ru и подтвердите почту — на баланс API придёт 300 ₽, этого хватит примерно на 240 запросов. В личном кабинете, в разделе «API и MCP», создайте ключ: он показывается один раз.

export SMARTPDF_API_KEY=sk_live_…

2. Выполните полный цикл

Пример сжимает document.pdf и сохраняет результат рядом — document_smartpdf.pdf. Код на всех языках проверен запуском против API.

Сжать PDF
#!/usr/bin/env bash
# SmartPDF API — Сжать PDF: загрузка → операция → ожидание → скачивание.
# Нужны curl и jq.
# Ключ — в личном кабинете: https://smartpdf.ru/dashboard/api-keys
set -euo pipefail
API="https://api.smartpdf.ru/v1"
AUTH="X-API-Key: $SMARTPDF_API_KEY"

# 1. Загрузить файл
FILE_ID=$(curl -sS --fail-with-body -H "$AUTH" -F "file=@document.pdf" "$API/upload" | jq -r .file_id)

# 2. Запустить операцию
BODY=$(jq -n --arg file_id "$FILE_ID" '{file_id: $file_id, level: "medium"}')
TASK_ID=$(curl -sS --fail-with-body -H "$AUTH" -H "Content-Type: application/json" \
  -d "$BODY" "$API/pdf/compress" | jq -r .task_id)

# 3. Дождаться результата
while :; do
  TASK=$(curl -sS --fail-with-body -H "$AUTH" "$API/tasks/$TASK_ID")
  STATUS=$(echo "$TASK" | jq -r .status)
  [ "$STATUS" = done ] && break
  [ "$STATUS" = failed ] && { echo "Ошибка обработки: $(echo "$TASK" | jq -r .error)" >&2; exit 1; }
  sleep 2
done

# 4. Скачать результат
RESULT=$(curl -sS --fail-with-body -H "$AUTH" "$API/tasks/$TASK_ID/download")
curl -sS --fail-with-body -o "$(echo "$RESULT" | jq -r .filename)" "$(echo "$RESULT" | jq -r .download_url)"
echo "Готово: $(echo "$RESULT" | jq -r .filename)"
bash quickstart.sh — нужны curl и jq

3. Что дальше

  • Операции — параметры каждой из 24 операций; шаг 2 меняется, остальное — как здесь.
  • Вебхуки — уведомление о готовности вместо опроса статуса.
  • Ошибки и лимиты — что проверять в продакшене.
  • MCP-сервер — те же операции для ИИ-агентов.

Эта страница для агентов: Markdown · llms.txt