Generar hash

Generar hash es una API que calcula el hash (MD5, SHA-1, SHA-256 o SHA-512) de un texto o de un fichero: para comprobar integridad, deduplicar, o generar una clave corta a partir de un dato largo.

Cómo funciona

Le mandas un texto (dentro de un JSON) o un fichero (a pelo, en el propio cuerpo de la petición) y te devuelve su hash. Es la única herramienta de Cofferdock que admite estas dos entradas pero SIEMPRE responde en JSON: un hash es un dato pequeñísimo, no un archivo que necesites descargar.

Lo único que necesitas

Tu API key. La creas en tu panel con "+ Crear llave". Se muestra una sola vez, así que cópiala y guárdala.
En tu plataforma de automatización, un paso de tipo "HTTP Request" / "Hacer una petición HTTP" (lo tienen n8n, Make, Zapier, Pipedream…).

Cómo usarlo en n8n (paso a paso)

En el nodo HTTP Request, para hashear un texto:

Method: POST
URL: https://api.cofferdock.com/hash
Send Headers: actívalo y añade dos: x-api-key = tu llave, y Content-Type = application/json
Send Body: actívalo → Body Content Type: JSON → { "text": "hola mundo", "algorithm": "sha256" }

Para hashear un fichero en vez de texto: Content-Type = application/octet-stream, y el cuerpo es el fichero en binario en vez de JSON (usa el parámetro algorithm en la URL, ej. ?algorithm=sha256, ya que en modo fichero no hay JSON donde meterlo).

En Make (módulo HTTP → Make a request): mismo método y URL, Body type: Raw, Content type: JSON, con el mismo cuerpo.

Opciones

Opción	Por defecto	Para qué sirve
`text`	-	El texto a hashear. Solo en modo JSON.
`algorithm`	`sha256`	`md5`, `sha1`, `sha256` o `sha512`.
`encoding`	`hex`	`hex` o `base64`.

Resumen de la API

Endpoint: POST https://api.cofferdock.com/hash
Auth: cabecera x-api-key: TU_LLAVE.
Entrada: JSON con { "text": "...", "algorithm"?, "encoding"? }, o un fichero a pelo (application/octet-stream) con algorithm/encoding como Query Parameters.
Salida: SIEMPRE JSON, sin modo binario (a diferencia de otras tools de Cofferdock): el resultado es un dato mínimo, no un fichero.
Motor: crypto.createHash() nativo de Node.js, sin dependencias.
Texto: se hashea como UTF-8 explícito, para que el resultado sea reproducible con herramientas externas.
Límites: text hasta 1.000.000 caracteres; fichero binario hasta 25 MB (igual para todos los planes). 30 peticiones/min por IP. 1 llamada = 1 crédito.

Opciones

Opción	Por defecto	Descripción
`text`	-	Obligatorio en modo JSON (ignorado en modo binario). No puede estar vacío.
`algorithm`	`sha256`	`md5 \| sha1 \| sha256 \| sha512` (400 si no está en la lista).
`encoding`	`hex`	`hex \| base64`.

Ejemplos

curl (texto):

curl -X POST "https://api.cofferdock.com/hash" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"hola mundo","algorithm":"sha256"}'

curl (fichero):

curl -X POST "https://api.cofferdock.com/hash?algorithm=sha256" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@documento.pdf"

JavaScript (Node 18+):

const r = await fetch('https://api.cofferdock.com/hash', {
  method: 'POST',
  headers: { 'x-api-key': 'TU_LLAVE', 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'hola mundo', algorithm: 'sha256' }),
});
const { hash } = await r.json();

Python:

import requests
r = requests.post(
    'https://api.cofferdock.com/hash',
    headers={'x-api-key': 'TU_LLAVE', 'Content-Type': 'application/json'},
    json={'text': 'hola mundo', 'algorithm': 'sha256'},
)
print(r.json())

Respuesta

{ "success": true, "hash": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
    "algorithm": "sha256", "encoding": "hex",
    "meta": { "input_mode": "text", "input_bytes": 5, "used": 12, "remaining": 488 } }

Lo que recibes

Un JSON con el hash en hash, más el algoritmo y la codificación usados. meta.input_mode te dice si se hasheó texto o un fichero.