API REST · documentación Swagger
Qué puedes crear
- CMS y blogs: pon un sello de tiempo a cada artículo o imagen al publicarlo.
- Herramientas de diseño y fotografía: registra automáticamente cada exportación.
- Flujos de documentos: fija la versión exacta de un contrato, una oferta o una factura.
- Pipelines de código: calcula la huella de los artefactos de cada versión en CI.
- Marketplaces: da a los vendedores una prueba de autoría por cada archivo subido.
Consigue una clave
- Abre https://run.secureauthor.com e inicia sesión con Google.
- Abre la sección «Clave de API» y haz clic en «Generar clave API».
- Copia la clave. Pásala como parámetro de consulta
api-key.
Referencia completa: documentación Swagger.
Crear un recibo
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, campo media = el archivo.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Respuesta (abreviada):
{
"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: se ha creado un recibo nuevo.code: 1: este archivo ya se había registrado; se devuelve el recibo original.blockchainLinkesnullhasta la siguiente ejecución de anclaje y después contiene el enlace a Polygonscan.nextEntryWritten: cuándo se espera el registro en la blockchain.
Verificar un archivo
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— campo media = el archivo que se comprueba, campo opcional pdf = el certificado.
Envía el certificado PDF o el ID del recibo.
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): el archivo coincide con el recibo; false (code 1): no coincide.
Errores
| Respuesta | Significado |
|---|---|
{"code": 3, "error": "API key is missing"} | Agrega ?api-key= a la URL |
{"code": 3, "error": "Invalid API key"} | Regenera la clave en la aplicación web |
| HTTP 400 | No hay archivo en el campo media o la petición está mal formada |