API
Documentazione dell'API REST del servizio SigCleaner.
Metodo: rimozione sfondo
POST https://sigclean.io/api/clean
Autorizzazione
Authorization: Bearer YOUR_API_KEY
Parametri della richiesta
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
file |
multipart file | Uno dei due | Immagine PNG, JPG o PDF |
url |
string | Uno dei due | Link diretto all'immagine |
type |
string | No | json (di default) — restituisce JSON con linkwebp — вернуть бинарный файл WebP с прозрачным фономpng — вернуть бинарный файл PNG с прозрачным фоном |
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
Возвращает бинарный файл WebP с прозрачным фоном.
Content-Type: image/webp.
Risposta: type=png
Возвращает бинарный файл PNG с прозрачным фоном.
Content-Type: image/png.
Примеры 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
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
Token Bearer o sessione attiva (cookie). Senza autorizzazione restituisce 401.
Authorization: Bearer YOUR_API_KEY
Risposta
{
"status": "ok",
"files": [
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"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"
}
]
}
| Campo | Tipo | Descrizione |
|---|---|---|
uuid |
string | ID univoco del file |
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 dell'archiviazione (UTC). null — il file è conservato a tempo indeterminato (utenti autorizzati). Per gli ospiti — created_at + 1 anno. |
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
Token Bearer o sessione attiva (cookie). Senza autorizzazione restituisce 401.
Authorization: Bearer YOUR_API_KEY
Corpo della richiesta application/json
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
uuid |
string | Sì | UUID del file dalla risposta /api/clean oppure /api/files |
Risposta
{ "status": "ok" }
Codici di errore
| Codice | Descrizione |
|---|---|
401 | Non autorizzato |
404 | File non trovato o non appartenente all'utente |
422 | Mancante o non valido uuid |
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"}'
Gestione chiavi API
Per gestire le chiavi è necessario accedere all'account.