API

Documentația REST API a serviciului SigCleaner.

Fiecare cerere reușită \/api\/clean deduce 1 procesare din soldul contului.

Metodă: eliminare fundal

POST https://sigclean.io/api/clean
Autorizare
Authorization: Bearer YOUR_API_KEY
Parametrii cererii
ParametruTipObligatoriuDescriere
file multipart file Unul din două Imagine PNG, JPG sau PDF.
Dacă fișierul PDF are mai multe pagini — este procesată doar prima pagină.
url string Unul din două Link direct către imagine
type string Nu json (implicit) — returnează JSON cu linkul către fișier
webp — returnează fișierul binar WebP cu fundal transparent
png — returnează fișierul binar PNG cu fundal transparent
extract string Nu Extragerea unui element specific. Implicit este gol — eliminare standard a fundalului.
signature — păstrează doar semnătura olografă, eliminând restul.
stamp — păstrează doar amprenta ștampilei, eliminând restul.
aggressive boolean Nu Eliminarea agresivă a textului.
Când este setat la 1 (true), elimină agresiv toate literele tipărite, cifrele și liniile negre drepte ale formularului, lăsând doar elementul specificat.
mode string Nu Mod de procesare. Implicit — standard.
standard — mod standard. Procesează excelent imaginile de calitate bună. Rezultatul este cât mai fidel originalului.
advanced — mod inteligent. Procesare mai amănunțită; potrivită pentru imagini de calitate slabă sau cu multe elemente nedorite.
name string Nu Numele afișat al fișierului în lista „Fișierele mele”. Este salvat la procesarea cu succes.
Răspuns: 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 }
Răspuns: type=webp

Returnează fișierul binar WebP cu fundal transparent. Content-Type: image/webp.

Răspuns: type=png

Returnează fișierul binar PNG cu fundal transparent. Content-Type: image/png.

Exemple 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

Extragerea semnăturii cu eliminarea agresivă a textului:

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

Mod inteligent de procesare:

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
Descarcă rezultatul
GET https://sigclean.io/api/file/{uuid}

Metodă: listă fișiere

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

Returnează o listă cu toate fișierele procesate cu succes care aparțin utilizatorului curent. Fișierele sunt disponibile prin link /api/file/{uuid}.

Autorizare
Authorization: Bearer YOUR_API_KEY
Răspuns
{ "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" } ] }
CâmpTipDescriere
uuid string Identificator unic al fișierului
name string | null Numele afișat al fișierului (din parametrul name la \/api\/clean sau după redenumire)
url string Link direct pentru descărcarea fișierului (WebP)
created_at string (ISO 8601) Data și ora creării fișierului (UTC)
expires_at string | null Data expirării stocării (UTC).
Exemplu cURL
curl https://sigclean.io/api/files \ -H "Authorization: Bearer YOUR_KEY"

Metodă: ștergere fișier

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

Șterge definitiv fișierul de pe server. Fișierul trebuie să aparțină utilizatorului curent.

Autorizare
Authorization: Bearer YOUR_API_KEY
Corpul cererii application\/json
ParametruTipObligatoriuDescriere
uuid string Da UUID-ul fișierului din răspunsul \/api\/clean sau \/api\/files.
Răspuns
{ "status": "ok" }
Coduri de eroare
CodDescriere
401Neautorizat
404Fișierul nu a fost găsit sau nu aparține utilizatorului
422uuid lipsă sau invalid
Exemplu 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"}'

Metodă: redenumire fișier

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

Modifică numele afișat al fișierului. Fișierul trebuie să aparțină utilizatorului curent.

Autorizare
Authorization: Bearer YOUR_API_KEY
Corpul cererii application\/json
ParametruTipObligatoriuDescriere
uuid string Da UUID-ul fișierului din răspunsul \/api\/clean sau \/api\/files.
name string Da Noul nume afișat al fișierului (până la 255 de caractere).
Răspuns
{ "status": "ok", "name": "stamp.jpg" }
Coduri de eroare
CodDescriere
401Neautorizat
404Fișierul nu a fost găsit sau nu aparține utilizatorului
422uuid \/ name lipsă sau invalid
Exemplu 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"}'

Gestionarea cheilor API

Pentru a gestiona cheile, trebuie să vă conectați la cont.