API

Documentazione dell'API REST del servizio SigCleaner.

Ogni richiesta \/api\/clean andata a buon fine scala 1 elaborazione dal saldo dell'account.

Metodo: rimozione sfondo

POST https://sigclean.io/api/clean
Autorizzazione
Authorization: Bearer YOUR_API_KEY
Parametri della richiesta
ParametroTipoObbligatorioDescrizione
file multipart file Uno dei due Immagine PNG, JPG o PDF.
Se il PDF è multipagina — viene elaborata solo la prima pagina.
url string Uno dei due Link diretto all'immagine
type string No json (predefinito) — restituisce un JSON con il link al file
webp — restituisce un file binario WebP con sfondo trasparente
png — restituisce un file binario PNG con sfondo trasparente
extract string No Estrazione di un elemento specifico. Vuoto per impostazione predefinita — rimozione standard dello sfondo.
signature — mantiene solo la firma autografa, rimuovendo tutto il resto.
stamp — mantiene solo l'impronta del timbro, rimuovendo tutto il resto.
aggressive boolean No Rimozione aggressiva del testo.
Se impostato su 1 (true), rimuove in modo aggressivo tutte le lettere stampate, i numeri e le linee nere dritte del modulo, lasciando solo l'elemento specificato.
mode string No Modalità di elaborazione. Predefinita — standard.
standard — modalità standard. Ideale per immagini di buona qualità. Il risultato è il più fedele possibile all'originale.
advanced — modalità intelligente. Elaborazione più accurata; adatta per immagini di scarsa qualità o con molti elementi indesiderati.
name string No Nome del file visualizzato nell'elenco «I miei file». Viene salvato in caso di elaborazione riuscita.
Risposta: 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 }
Risposta: type=webp

Restituisce un file binario WebP con sfondo trasparente. Content-Type: image/webp.

Risposta: type=png

Restituisce un file binario PNG con sfondo trasparente. Content-Type: image/png.

Esempi 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

Estrazione della firma con rimozione aggressiva delle scritte:

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

Modalità di elaborazione intelligente:

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

Metodo: elenco file

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

Restituisce un elenco di tutti i file elaborati con successo appartenenti all'utente corrente. I file sono disponibili tramite link /api/file/{uuid}.

Autorizzazione
Authorization: Bearer YOUR_API_KEY
Risposta
{ "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" } ] }
CampoTipoDescrizione
uuid string ID univoco del file
name string | null Nome del file visualizzato (dal parametro name in \/api\/clean o dopo la rinominazione)
url string Link diretto per il download del file (WebP)
created_at string (ISO 8601) Data e ora di creazione del file (UTC)
expires_at string | null Data di scadenza della conservazione (UTC).
Esempio cURL
curl https://sigclean.io/api/files \ -H "Authorization: Bearer YOUR_KEY"

Metodo: eliminazione file

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

Elimina definitivamente il file dal server. Il file deve appartenere all'utente corrente.

Autorizzazione
Authorization: Bearer YOUR_API_KEY
Corpo della richiesta application\/json
ParametroTipoObbligatorioDescrizione
uuid string Sì UUID del file dalla risposta \/api\/clean o \/api\/files.
Risposta
{ "status": "ok" }
Codici di errore
CodiceDescrizione
401Non autorizzato
404File non trovato o non appartenente all'utente
422uuid mancante o non valido
Esempio 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"}'

Metodo: rinominazione file

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

Modifica il nome del file visualizzato. Il file deve appartenere all'utente corrente.

Autorizzazione
Authorization: Bearer YOUR_API_KEY
Corpo della richiesta application\/json
ParametroTipoObbligatorioDescrizione
uuid string Sì UUID del file dalla risposta \/api\/clean o \/api\/files.
name string Sì Nuovo nome del file visualizzato (fino a 255 caratteri).
Risposta
{ "status": "ok", "name": "stamp.jpg" }
Codici di errore
CodiceDescrizione
401Non autorizzato
404File non trovato o non appartenente all'utente
422uuid \/ name mancante o non valido
Esempio 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"}'

Gestione chiavi API

Per gestire le chiavi è necessario accedere all'account.