SIGNATURUM PER SVILUPPATORI

Un'API per l'intero flusso di protezione dei contenuti

Aggiungi depositi verificabili, filigrana invisibile, file gestiti, incorporamento sicuro, monitoraggio delle copie e licenze desktop al tuo prodotto tramite un'unica interfaccia versionata.

Documentazione APIGestisci chiavi APIVisualizza i piani
URL di basehttps://signaturum.com/api/v1Billing runtime 2.1

Dalla protezione al monitoraggio delle violazioni

L'API espone gli stessi servizi commerciali del pannello di controllo e delle applicazioni desktop di Signaturum, mantenendo permessi, utilizzo e fatturazione sotto controllo centralizzato.

Depositi digitali

Registra un'impronta digitale SHA-256 o carica un file per l'hashing lato server. Recupera lo stato del record, i riferimenti ai certificati e i metadati blockchain.

Filigrana invisibile V72 (Watermark)

Proteggi immagini, video e PDF, esegui il rilevamento, monitora i lavori asincroni e scarica i risultati protetti completati.

Archiviazione gestita

Carica, elenca, visualizza in anteprima, trasmetti in streaming, scarica ed elimina file sotto un'archiviazione gestita a livello centrale, con limiti per la durata dei media e le pagine PDF.

Incorporamento sicuro

Utilizza i contenuti archiviati in incorporamenti controllati con diritti su visualizzazioni, larghezza di banda, dominio, concorrenza e branding.

Monitoraggio Crawler

Crea oggetti monitorati, avvia scansioni e recupera lavori, candidati, avvisi e fonti supportate con profondità e frequenza controllate dal piano.

Licenze Desktop

Attiva e convalida le licenze delle applicazioni desktop tramite un ambito (scope) dedicato senza esporre autorizzazioni dell'account più ampie.

Fatturazione API commerciale senza contatori nascosti

L'accesso all'API e il consumo del prodotto sono intenzionalmente separati. Ciò consente di prezzare il carico dell'infrastruttura indipendentemente dal valore aziendale di depositi, lavori di filigrana, archiviazione o scansioni del crawler.

1. Limite di abbonamento API

Ogni richiesta utilizza il piano API attivo condiviso da tutte le chiavi in quell'abbonamento: i limiti di minuti, giorni, mesi, concorrenza e dimensioni di caricamento vengono applicati a livello centrale.

2. Diritto al prodotto

L'operazione richiesta deve essere disponibile anche nel pacchetto del prodotto: deposit.records, watermark.generations, vault.*, embed.* o crawler.*. Le chiamate in sola lettura normalmente consumano solo richieste API.

Limiti imposti dalla piattaforma

I valori sono configurati in Billing V2 e possono differire in base al piano o alle sostituzioni dell'account. L'endpoint /usage restituisce i limiti effettivi e il consumo corrente.

api.requests_minuteRichieste consentite nel minuto corrente per l'intero abbonamento.
api.requests_dayRichieste consentite nel giorno UTC corrente per l'intero abbonamento.
api.requests_monthRichieste consentite nel periodo di fatturazione attivo.
api.concurrent_requestsMassimo di richieste in esecuzione simultanee utilizzando lease brevi.
api.max_upload_bytesDimensione massima accettata del corpo/file per un caricamento.

Produzione e sandbox sono separati

Il prefisso della chiave identifica in modo univoco l'ambiente e impedisce che le credenziali di test vengano scambiate per credenziali di produzione.

  • sg_live_… — chiave di produzione; utilizza permessi, uso e pacchetti prodotto reali.
  • sg_test_… — chiave di prova; richiede l'accesso sandbox nel piano API.

Ambiti (scopes) con privilegi minimi

Emetti chiavi separate per ogni applicazione e concedi solo le azioni necessarie. I vecchi ambiti ampi continuano ad essere accettati durante la migrazione.

usage:readdeposit:readdeposit:writewatermark:readwatermark:protectwatermark:detectfiles:readfiles:writecrawler:readcrawler:writedesktop:license

Ispeziona l'utilizzo prima di un'operazione pesante

GET /usage restituisce i limiti dell'API più i saldi dei prodotti, in modo che un'integrazione possa posticipare il lavoro o mostrare un messaggio di upgrade preciso prima di iniziare un lotto di grandi dimensioni.

GET /api/v1/usagecURL
curl https://signaturum.com/api/v1/usage \
  -H "Authorization: Bearer sg_live_YOUR_API_KEY" \
  -H "Accept: application/json"

Pronto a integrare Signaturum?

Crea una chiave limitata (scoped), prova nella sandbox e sposta la stessa integrazione in produzione quando è pronta.

Crea una chiave APIRiferimento tecnico