API

Dokumentasi REST API layanan SigCleaner.

Setiap permintaan \/api\/clean yang berhasil akan memotong 1 pemrosesan dari saldo akun.

Metode: penghapusan latar belakang

POST https://sigclean.io/api/clean
Otorisasi
Authorization: Bearer YOUR_API_KEY
Parameter permintaan
ParameterTipeWajibDeskripsi
file multipart file Salah satu dari dua Gambar PNG, JPG, atau PDF.
Jika PDF memiliki banyak halaman — hanya halaman pertama yang diproses.
url string Salah satu dari dua Tautan langsung ke gambar
type string Tidak json (default) — mengembalikan JSON dengan tautan ke file
webp — mengembalikan file biner WebP dengan latar belakang transparan
png — mengembalikan file biner PNG dengan latar belakang transparan
extract string Tidak Ekstraksi elemen tertentu. Kosong secara default — penghapusan latar belakang standar.
signature — hanya menyimpan tanda tangan tulisan tangan, menghapus semua bagian lainnya.
stamp — hanya menyimpan cap stempel, menghapus semua bagian lainnya.
aggressive boolean Tidak Penghapusan teks secara agresif.
Jika diatur ke 1 (true), secara agresif menghapus semua huruf cetak, angka, dan garis hitam lurus pada formulir, hanya menyisakan elemen yang ditentukan.
mode string Tidak Mode pemrosesan. Default — standard.
basic — pembersihan ringan. Hanya menghapus latar belakang, menyisakan semua elemen lainnya.
standard — pembersihan standar (Ultra). Menghapus latar belakang dan elemen yang tidak perlu, seperti teks. Cocok untuk sebagian besar kasus.
advanced — pembersihan mendalam (Ultra). Memproses gambar menggunakan algoritme cerdas. Cocok untuk file berkualitas rendah atau dengan banyak elemen asing. Dalam mode ini, Anda dapat memilih objek ekstraksi atau pembersihan elemen asing secara agresif.
name string Tidak Nama file yang ditampilkan dalam daftar «File Saya». Disimpan saat pemrosesan berhasil.
Respons: type=json
{ "status": "ok", "uuid": "550e8400-e29b-41d4-a716-446655440000", "url": "https://sigclean.io/api/file/550e8400-e29b-41d4-a716-446655440000", "remaining": 9, "limit": 10 }
Respons: type=webp

Mengembalikan file biner WebP dengan latar belakang transparan. Content-Type: image/webp.

Respons: type=png

Mengembalikan file biner PNG dengan latar belakang transparan. Content-Type: image/png.

Contoh cURL
curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=json"
curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=png" \ --output result.png
curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=webp" \ --output result.webp

Ekstraksi tanda tangan dengan penghapusan teks agresif:

curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@document.jpg" \ -F "type=png" \ -F "extract=signature" \ -F "aggressive=1" \ --output signature.png

Pembersihan mendalam:

curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=png" \ -F "mode=advanced" \ --output result.png
Unduh hasil
GET https://sigclean.io/api/file/{uuid}

Metode: daftar file

GET https://sigclean.io/api/files

Mengembalikan daftar semua file yang berhasil diproses milik pengguna saat ini. File tersedia melalui tautan /api/file/{uuid}.

Otorisasi
Authorization: Bearer YOUR_API_KEY
Respons
{ "status": "ok", "files": [ { "uuid": "550e8400-e29b-41d4-a716-446655440000", "name": "stamp.jpg", "url": "https://sigclean.io/api/file/550e8400-e29b-41d4-a716-446655440000", "created_at": "2026-07-01T10:00:00Z", "expires_at": "2027-07-01T10:00:00Z" } ] }
BidangTipeDeskripsi
uuid string ID unik file
name string | null Nama file yang ditampilkan (dari parameter name pada \/api\/clean atau setelah penggantian nama)
url string Tautan langsung untuk mengunduh file (WebP)
created_at string (ISO 8601) Tanggal dan waktu pembuatan file (UTC)
expires_at string | null Tanggal kedaluwarsa penyimpanan (UTC).
Contoh cURL
curl https://sigclean.io/api/files \ -H "Authorization: Bearer YOUR_KEY"

Metode: penghapusan file

POST https://sigclean.io/api/files/delete

Menghapus file dari server secara permanen. File harus milik pengguna saat ini.

Otorisasi
Authorization: Bearer YOUR_API_KEY
Isi permintaan application\/json
ParameterTipeWajibDeskripsi
uuid string Ya UUID file dari respons \/api\/clean atau \/api\/files.
Respons
{ "status": "ok" }
Kode kesalahan
KodeDeskripsi
401Tidak diotorisasi
404File tidak ditemukan atau bukan milik pengguna
422uuid tidak diberikan atau tidak valid
Contoh cURL
curl -X POST https://sigclean.io/api/files/delete \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"uuid":"550e8400-e29b-41d4-a716-446655440000"}'

Metode: penggantian nama file

POST https://sigclean.io/api/files/rename

Mengubah nama file yang ditampilkan. File harus milik pengguna saat ini.

Otorisasi
Authorization: Bearer YOUR_API_KEY
Isi permintaan application\/json
ParameterTipeWajibDeskripsi
uuid string Ya UUID file dari respons \/api\/clean atau \/api\/files.
name string Ya Nama file baru yang ditampilkan (hingga 255 karakter).
Respons
{ "status": "ok", "name": "stamp.jpg" }
Kode kesalahan
KodeDeskripsi
401Tidak diotorisasi
404File tidak ditemukan atau bukan milik pengguna
422uuid \/ name tidak diberikan atau tidak valid
Contoh cURL
curl -X POST https://sigclean.io/api/files/rename \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"uuid":"550e8400-e29b-41d4-a716-446655440000","name":"stamp.jpg"}'

Manajemen kunci API

Untuk mengelola kunci, Anda harus masuk ke akun.