Memisahkan pdf API

Memisahkan pdf API, PdfSplit menghubungkan pekerjaan ke aplikasi Anda sendiri: Anda mengirim file, memeriksa pekerjaan, dan mengunduh output. Endpoint berjalan di server; tidak ada browser dalam alur.

Mulai cepat

Buat kunci di bagian API Pengembang di akun Anda; kunci teks polos hanya ditampilkan saat dibuat.
Kirim permintaan ke https://api.pixepi.com dengan header Authorization: Bearer <key>.
Pantau pekerjaan dalam respons dengan GET https://api.pixepi.com/api/v1/jobs/{id}; setelah statusnya done, unduh output dari download_url.

Contoh permintaan

curl -X POST "https://api.pixepi.com/api/v1/apps/pdfsplit/run" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -F "[email protected]" \
  -F "options[mode]=pages" \
  -F "options[page_range]=1-3"

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

Endpoint alat ini

Metode	Path	Fungsinya
`POST`	`/run`	Menjalankan alat, memulai pekerjaan, dan mengembalikan hasilnya.

Opsi

Opsi dikirim sebagai options[<field>]; kolom yang dibiarkan kosong memakai default-nya.

Kolom	Nilai	Default
`options[mode]` Mode pemisahan	pages · range · chunks	`pages`
`options[page_range]` Rentang halaman		`1-3`
`options[chunk_size]` Ukuran bagian	1–500	`5`
`options[merge_output]` Gabungkan rentang menjadi satu PDF	aktif · nonaktif	`nonaktif`

Endpoint bersama

Metode	Path	Fungsinya
`GET`	`/api/v1/apps`	Katalog API
`GET`	`/api/v1/apps/pdfsplit`	Kontrak alat
`GET`	`/api/v1/jobs/{id}`	Status pekerjaan
`GET`	`/api/v1/jobs/{id}/download`	Unduh output pekerjaan
`GET`	`/api/v1/usage`	Ringkasan penggunaan
`GET`	`/api/v1/openapi.json`	Dokumen OpenAPI 3.1

Batas

Maksimal 100 MB per file.
Informasi kuota dan paket terikat ke akun Anda; periksa status terkini dengan GET /api/v1/usage.

Kode error

Kode	Arti
`unauthorized`	Kunci API tidak ada atau tidak valid.
`forbidden`	Operasi ini tidak diizinkan dengan kunci ini.
`not_found`	Alat, pekerjaan, atau catatan tidak ditemukan (404 juga untuk akses lintas akun).
`invalid_input`	Input gagal validasi (kolom kurang atau cacat, tanggal tidak valid, dan sebagainya).
`invalid_request`	Permintaan cacat.
`too_large`	Ukuran file atau body melebihi batas.
`unsupported_media`	Jenis file tidak diterima.
`not_supported`	Alat ini tidak dapat berjalan di endpoint ini (aplikasi berstatus).
`not_ready`	Pekerjaan belum selesai.
`expired`	Output sudah kedaluwarsa.
`no_output`	Tidak ada output yang dapat diunduh untuk pekerjaan ini.
`invalid_path`	Path output tidak valid.
`quota_exceeded`	Kuota atau batas laju terlampaui.
`rate_limited`	Terlalu banyak permintaan dalam waktu singkat; tunggu sebentar dan coba lagi.
`csrf`	Verifikasi formulir browser gagal (API eksternal memakai kunci).
`conflict`	Operasi bertentangan dengan status saat ini.
`unavailable`	Alat ditutup sementara.
`internal_error`	Error server tak terduga.

Dokumen

Pertanyaan yang sering diajukan

Di mana saya mendapatkan kunci API?

Buat kunci di bagian API Pengembang di akun Anda; kunci ditampilkan sekali, saat dibuat.

Bagaimana permintaan dikirim?

Endpoint berjalan di https://api.pixepi.com; setiap permintaan menyertakan header "Authorization: Bearer <key>".

File apa yang diterima API PdfSplit?

Jenis yang diterima: PDF. Batasnya 100 MB per file; opsinya sama seperti di halaman alat.

Bagaimana cara membaca respons error?

Body error membawa kolom {ok:false, error, code, request_id}; nilai code ada di tabel kode error.