API de sellado de tiempo gratuita

La API de SecureAuthor permite que tu software registre archivos y los verifique. Envía un archivo por POST para crear un recibo con su hash SHA-256 y su sello de tiempo UTC, anclado en la blockchain de Polygon dos veces al día; envía un archivo con un certificado o un ID de recibo para comprobar si coinciden. La API es gratuita, pública y está documentada en Swagger.

Consigue una clave API gratis

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

  1. Abre https://run.secureauthor.com e inicia sesión con Google.
  2. Abre la sección «Clave de API» y haz clic en «Generar clave API».
  3. 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.
  • blockchainLink es null hasta 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

RespuestaSignificado
{"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 400No hay archivo en el campo media o la petición está mal formada

Preguntas frecuentes

¿Cuánto cuesta la API?

Es gratis. No hay planes de pago ni límites de peticiones publicados; el acceso solo puede suspenderse en caso de abuso, como se describe en las Condiciones de uso.

¿Cómo consigo una clave API?

Inicia sesión en la aplicación web con Google, abre la sección «Clave de API» y haz clic en «Generar clave API». Puedes regenerarla en cualquier momento; la clave anterior deja de funcionar.

¿Puedo enviar solo un hash en lugar del archivo?

La API actual acepta el propio archivo, calcula el hash SHA-256 en el servidor y no almacena el archivo.

¿Los recibos de la API son iguales que los de la web?

Sí. Aparecen en el historial de tu cuenta y pueden verificarse en la aplicación web, en la extensión o a través de la API.

Actualizado:

Protege tu próximo archivo en segundos

Prueba de autoría gratuita: hash SHA-256, sello de tiempo UTC y registro en la blockchain de Polygon. Tu archivo no se almacena.

Agregar a ChromeProtege un archivo