babox API v1

Программный интерфейс для автоматической обработки документов. Работает с любого языка, который умеет отправлять HTTP-запросы (Python, PHP, JS, C#, Excel-макросы и т.д.).

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

Все запросы требуют заголовок:

Authorization: Bearer ВАШ_КЛЮЧ

POST /v1/pdf — HTML в PDF

Принимает HTML, возвращает готовый PDF-файл. Поддерживает кириллицу, таблицы, стили, рубли.

curl -X POST https://api.babox.ru/v1/pdf \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Счёт №123</h1><p>ООО «Ромашка»</p>",
    "filename": "schet-123.pdf"
  }' -o schet.pdf

Python

import requests
r = requests.post("https://api.babox.ru/v1/pdf",
    headers={"Authorization": "Bearer ВАШ_КЛЮЧ"},
    json={"html": "<h1>Счёт</h1>", "filename": "schet.pdf"})
open("schet.pdf", "wb").write(r.content)

PHP

<?php
$ch = curl_init("https://api.babox.ru/v1/pdf");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer ВАШ_КЛЮЧ",
                         "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["html" => "<h1>Счёт</h1>"]),
  CURLOPT_RETURNTRANSFER => true,
]);
file_put_contents("schet.pdf", curl_exec($ch));

POST /v1/pdf-url — страница по URL в PDF

Скачивает страницу по адресу и возвращает её как PDF. Удобно для архивов, отчётов и мониторинга контента.

curl -X POST https://api.babox.ru/v1/pdf-url   -H "Authorization: Bearer ВАШ_КЛЮЧ"   -H "Content-Type: application/json"   -d '{"url": "https://example.com/page", "filename": "page.pdf"}'   -o page.pdf

Внутренние адреса (localhost, приватные сети) запрещены — защита от злоупотребления.

Параметры

Коды ответа

Поддержка

Вопросы, интеграция, нестандартные задачи: api@babox.ru