Lewati ke konten utama
open-toolsopen-tools

API

open-tools API

Akses programatik ke semua alat kami. Gunakan untuk menghubungkan pekerjaan PDF atau gambar massal ke pipeline Anda sendiri.

Mulai cepat

  1. Buat akun jika Anda belum punya.
  2. Buat kunci API dari Akun → Kunci API. Token lengkap ditampilkan sekali; salin sekarang.
  3. 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"] }
    }
  }
}
HTTPKodeArti
400INVALID_FILE_TYPEEkstensi file tidak ada dalam allow-list pekerjaan ini.
400INVALID_FILE_SIGNATUREMagic bytes tidak cocok dengan ekstensi.
400INVALID_PARAMETERSParameter parameters JSON gagal validasi skema.
401AUTH_REQUIREDTidak ada cookie sesi atau kunci API pada permintaan.
403REAUTH_REQUIREDTindakan sensitif; sesi lebih lama dari 15 min.
413FILE_TOO_LARGEUnggahan melebihi batas 50 MB.
429RATE_LIMITEDJendela tier terlampaui. Lihat Retry-After.
500INTERNAL_ERRORBug. 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.