API
open-tools API
Akses programatik ke semua alat kami. Gunakan untuk menghubungkan pekerjaan PDF atau gambar massal ke pipeline Anda sendiri.
Mulai cepat
- Buat akun jika Anda belum punya.
- Buat kunci API dari Akun → Kunci API. Token lengkap ditampilkan sekali; salin sekarang.
- Kirim token sebagai
Authorization: Bearer otk_…pada setiap permintaan.
Referensi
Spec OpenAPI lengkap — setiap endpoint, setiap parameter, setiap bentuk respons — dibuat otomatis dari aplikasi FastAPI dan disajikan sebagai JSON. Swagger UI dan ReDoc sama-sama merendernya.
Buka referensi API interaktif →Lebih suka spec mentah atau konsol langsung? JSON OpenAPI yang dapat dibaca mesin serta penjelajah Swagger / ReDoc tersedia untuk akun yang sudah masuk:
Contoh — pisah PDF
Unggah file dan polling hasilnya:
# 1. Upload and create the job
curl -X POST 'https://api.open-tools.app/api/upload' \
-H 'Authorization: Bearer otk_YOUR_KEY' \
-F 'file=@input.pdf' \
-F 'job_type=pdf-split' \
-F 'parameters={"pages": "1-3"}'
# → {"job_id": "abc123", "status": "queued", "ws_token": "..."}
# 2. Poll job status (or subscribe via WebSocket /ws/<job_id>?token=<ws_token>)
curl 'https://api.open-tools.app/api/jobs/abc123' \
-H 'Authorization: Bearer otk_YOUR_KEY'
# → {"status": "completed", "output_file_url": "https://api.open-tools.app/api/download/users/42/..."}
# 3. Download the result
curl -o output.pdf 'https://api.open-tools.app/api/download/users/42/<uuid>.pdf' \
-H 'Authorization: Bearer otk_YOUR_KEY'Kode kesalahan
Semua kesalahan berbagi bentuk envelope yang sama:
{
"detail": {
"error": {
"code": "INVALID_FILE_TYPE",
"message": "image-resize requires PNG, JPG, or WEBP.",
"details": { "expected_extensions": [".png", ".jpg", ".webp"] }
}
}
}| HTTP | Kode | Arti |
|---|---|---|
| 400 | INVALID_FILE_TYPE | Ekstensi file tidak ada dalam allow-list pekerjaan ini. |
| 400 | INVALID_FILE_SIGNATURE | Magic bytes tidak cocok dengan ekstensi. |
| 400 | INVALID_PARAMETERS | Parameter parameters JSON gagal validasi skema. |
| 401 | AUTH_REQUIRED | Tidak ada cookie sesi atau kunci API pada permintaan. |
| 403 | REAUTH_REQUIRED | Tindakan sensitif; sesi lebih lama dari 15 min. |
| 413 | FILE_TOO_LARGE | Unggahan melebihi batas 50 MB. |
| 429 | RATE_LIMITED | Jendela tier terlampaui. Lihat Retry-After. |
| 500 | INTERNAL_ERROR | Bug. Harap sertakan request_id header. |
Batas laju & penggunaan
Setiap akun mendapat bucket per-menit, per-hour, per-hari, dan per-bulan. Penggunaan saat ini terlihat di dashboard akun Anda. Kena 429? Tunggu jendela bergeser; respons menyertakanRetry-After detik.