API di marca temporale gratuita

L'API di SecureAuthor permette al tuo software di registrare file e verificarli. Con una POST di un file crei una ricevuta con hash SHA-256 e marca temporale UTC, ancorata sulla blockchain Polygon due volte al giorno; con una POST di un file più certificato o ID della ricevuta controlli se corrispondono. L'API è gratuita, pubblica e documentata in Swagger.

Ottieni una chiave API gratuita

API REST · documentazione Swagger

Che cosa puoi costruire

  • CMS e blog: una marca temporale su ogni articolo o immagine alla pubblicazione.
  • Strumenti di grafica e fotografia: registra automaticamente ogni esportazione.
  • Flussi documentali: fissa la versione esatta di un contratto, di un'offerta o di una fattura.
  • Pipeline di codice: crea l'impronta degli artefatti di release in CI.
  • Marketplace: dai ai venditori una prova di paternità per ogni caricamento.

Ottieni una chiave

  1. Apri https://run.secureauthor.com e accedi con Google.
  2. Apri la sezione «Chiave API» e premi «Genera chiave API».
  3. Copia la chiave. Passala come parametro di query api-key.

Documentazione completa: documentazione Swagger.

Creare una ricevuta

POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY — multipart/form-data, campo media = il file.

curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
  -F "media=@artwork.png"

Risposta (abbreviata):

{
  "code": 0,
  "message": "Receipt created successfully",
  "receipt": {
    "id": "cm8ixlzwf0002pj42vqmvev62",
    "hash": "26be856c7aa5748040bcf998b18d3081cacb2ab1e4e3b34aece9e86152f083aa",
    "timeStamp": "2025-03-21T15:25:13.599Z",
    "blockchainLink": null,
    "fileName": "artwork",
    "fileMimeType": "png",
    "fileSize": 26106,
    "nextEntryWritten": "2025-03-22T00:00:00.000Z"
  }
}
  • code: 0: è stata creata una nuova ricevuta.
  • code: 1: questo file era già stato registrato; viene restituita la ricevuta originale.
  • blockchainLink è null fino al ciclo di ancoraggio successivo, poi contiene il link a Polygonscan.
  • nextEntryWritten: quando è prevista la registrazione on-chain.

Verificare un file

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — campo media = il file da controllare, campo facoltativo pdf = il certificato. Passa il PDF del certificato oppure l'ID della ricevuta.

curl -X POST "https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY&hash-id=cm8j56xxh0007pj42mj8eg7rl" \
  -F "media=@artwork.png"
{
  "code": 0,
  "fileHash": "a535b2b5…d0",
  "receiptHash": "a535b2b5…d0",
  "receiptId": "cm8j56xxh0007pj42mj8eg7rl",
  "isEqual": true
}

isEqual: true (code 0): il file corrisponde alla ricevuta; false (code 1): non corrisponde.

Errori

RispostaSignificato
{"code": 3, "error": "API key is missing"}Aggiungi ?api-key= all'URL
{"code": 3, "error": "Invalid API key"}Rigenera la chiave nell'app web
HTTP 400Nessun file nel campo media o richiesta malformata

Domande frequenti

Quanto costa l'API?

È gratuita. Non ci sono piani a pagamento né limiti di richieste pubblicati; l'accesso può essere sospeso solo in caso di abuso, come previsto dai Termini di utilizzo.

Come ottengo una chiave API?

Accedi all'app web con Google, apri la sezione «Chiave API» e premi «Genera chiave API». Puoi rigenerarla in qualsiasi momento; la chiave vecchia smette di funzionare.

Posso inviare solo un hash invece del file?

L'API attuale accetta il file stesso, calcola l'hash SHA-256 sul server e non conserva il file.

Le ricevute dell'API sono uguali a quelle web?

Sì. Compaiono nello storico del tuo account e si possono verificare nell'app web, nell'estensione o tramite l'API.

Aggiornato:

Proteggi il tuo prossimo file in pochi secondi

Prova di paternità gratuita: hash SHA-256, marca temporale UTC e registrazione sulla blockchain Polygon. Il tuo file non viene conservato.

Aggiungi a ChromeProteggi un file