Разделить pdf на страницы API

Разделить pdf на страницы API, PdfSplit подключает задачу к вашему приложению: вы отправляете файл, проверяете статус задачи и скачиваете результат. Эндпоинты выполняются на сервере без участия браузера.

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

Создайте ключ в разделе API для разработчиков вашего аккаунта; ключ в открытом виде отображается только в момент создания.
Отправьте запрос на https://api.pixepi.com с заголовком Authorization: Bearer <key>.
Опрашивайте задачу из ответа с помощью GET https://api.pixepi.com/api/v1/jobs/{id}; когда статус изменится на done, скачайте результат по адресу из download_url.

Пример запроса

curl -X POST "https://api.pixepi.com/api/v1/apps/pdfsplit/run" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -F "file=@файл.pdf" \
  -F "options[mode]=pages" \
  -F "options[page_range]=1-3"

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/jobs/42"

Эндпоинты этого инструмента

Метод	Путь	Назначение
`POST`	`/run`	Запускает инструмент, создает задачу и возвращает результат.

Параметры

Параметры передаются как options[<field>]; для пустого поля используется значение по умолчанию.

Поле	Значения	По умолчанию
`options[mode]` Режим разделения	pages · range · chunks	`pages`
`options[page_range]` Диапазоны страниц		`1-3`
`options[chunk_size]` Размер части	1–500	`5`
`options[merge_output]` Объединить диапазоны в один PDF	включено · отключено	`отключено`

Общие эндпоинты

Метод	Путь	Назначение
`GET`	`/api/v1/apps`	Каталог API
`GET`	`/api/v1/apps/pdfsplit`	Контракт инструмента
`GET`	`/api/v1/jobs/{id}`	Статус задачи
`GET`	`/api/v1/jobs/{id}/download`	Скачать результат задачи
`GET`	`/api/v1/usage`	Сводка использования
`GET`	`/api/v1/openapi.json`	Документ OpenAPI 3.1

Ограничения

Не более 100 MB на файл.
Информация о квотах и тарифе привязана к вашему аккаунту; проверьте текущее состояние с помощью GET /api/v1/usage.

Коды ошибок

Код	Значение
`unauthorized`	Ключ API отсутствует или недействителен.
`forbidden`	Эта операция запрещена с данным ключом.
`not_found`	Инструмент, задача или запись не найдены (404 также при доступе из другого аккаунта).
`invalid_input`	Ошибка проверки входных данных (пропущено или повреждено поле, неверная дата и т. д.).
`invalid_request`	Некорректный запрос.
`too_large`	Размер файла или тела запроса превышает лимит.
`unsupported_media`	Тип файла не поддерживается.
`not_supported`	Этот инструмент не может работать на этой конечной точке (stateful app).
`not_ready`	Задача еще не завершена.
`expired`	Срок действия файла истек.
`no_output`	Нет готовых файлов для скачивания.
`invalid_path`	Недопустимый путь к файлу.
`quota_exceeded`	Превышена квота или лимит запросов.
`rate_limited`	Слишком много запросов за короткое время; подождите немного и повторите попытку.
`csrf`	Ошибка проверки формы браузера (внешний API использует ключи).
`conflict`	Операция конфликтует с текущим состоянием.
`unavailable`	Инструмент временно недоступен.
`internal_error`	Непредвиденная ошибка сервера.

Документы

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

Где получить API-ключ?

Создайте ключ в разделе API для разработчиков вашего аккаунта; ключ показывается только один раз в момент создания.

Как отправить запрос?

Эндпоинты доступны по адресу https://api.pixepi.com; каждый запрос должен содержать заголовок "Authorization: Bearer <key>".

Какие файлы принимает API PdfSplit?

Поддерживаемые форматы: PDF. Лимит — 100 MB на файл; параметры совпадают с указанными на странице инструмента.

Как обрабатывать ответ с ошибкой?

Тело ошибки содержит поля {ok:false, error, code, request_id}; возможные значения кода приведены в таблице кодов ошибок.