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
- Apri https://run.secureauthor.com e accedi con Google.
- Apri la sezione «Chiave API» e premi «Genera chiave API».
- 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ènullfino 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
| Risposta | Significato |
|---|---|
{"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 400 | Nessun file nel campo media o richiesta malformata |