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.
standard — mode standar. Berfungsi dengan baik untuk gambar berkualitas bagus. Hasilnya akan semirip mungkin dengan aslinya.
advanced — mode cerdas. Pemrosesan yang lebih teliti; cocok untuk gambar berkualitas rendah atau dengan banyak elemen pengganggu.
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

Mode pemrosesan cerdas:

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 error
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 error
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.