API key
Clave API (recomendado)
Crea claves hz_live_ en tu cuenta. El secreto completo solo se muestra al crearla.
API de análisis de malware
URL base https://hashzyn.onrender.com. Auth: Authorization: Bearer hz_live_… o token de sesión Supabase.
URL base https://hashzyn.onrender.com
Envía un Bearer en cada petición. Claves API para servidores/CI; sesión para tus apps.
API key
Crea claves hz_live_ en tu cuenta. El secreto completo solo se muestra al crearla.
Session
Tras iniciar sesión, pasa el access token igual.
Authorization: Bearer hz_live_xxxxxxxx Content-Type: application/json
Cada análisis devuelve un veredicto y el desglose de fuentes. Las muestras no se almacenan.
Veredictos: clean · suspicious · malicious · unknown
/v1/scan/lookupLook up a SHA-256 without uploading the file. If unknown, response may include needsUpload: true.
curl -s https://hashzyn.onrender.com/v1/scan/lookup \
-H "Authorization: Bearer hz_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"sha256":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","filename":"empty"}'Ejemplo de respuesta
{
"id": "scn_…",
"status": "done",
"verdict": "unknown",
"sha256": "e3b0…",
"needsUpload": true,
"sources": [
{ "engine": "hash_intel", "verdict": "unknown", "found": false }
]
}/v1/scan/fileMultipart upload. Free plan max 3 MB; Starter/Pro max 10 MB. Sample bytes are discarded after the request — not archived.
curl -s https://hashzyn.onrender.com/v1/scan/file \ -H "Authorization: Bearer hz_live_YOUR_KEY" \ -F "file=@sample.bin" \ -F "sha256=YOUR_SHA256"
/v1/scan/urlCheck a URL against threat feeds and page-source heuristics.
curl -s https://hashzyn.onrender.com/v1/scan/url \
-H "Authorization: Bearer hz_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/suspicious"}'/v1/scan/textPaste JavaScript, PHP, HTML, or other text for heuristic analysis.
curl -s https://hashzyn.onrender.com/v1/scan/text \
-H "Authorization: Bearer hz_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"content":"eval(atob(\"…\"))","language":"javascript"}'/v1/scan/:idFetch a previously created scan result by id.
curl -s https://hashzyn.onrender.com/v1/scan/scn_YOUR_ID \ -H "Authorization: Bearer hz_live_YOUR_KEY"
/v1/hash/:sha256Read cached HashZyn reputation for a SHA-256 (no auth required). Also available as a shareable page on the site.
curl -s https://hashzyn.onrender.com/v1/hash/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
/v1/meReturns plan, credits, and dailyRemaining for the authenticated user.
curl -s https://hashzyn.onrender.com/v1/me \ -H "Authorization: Bearer hz_live_YOUR_KEY"
Ejemplo de respuesta
{
"id": "…",
"email": "you@example.com",
"plan": "free",
"credits": 0,
"dailyRemaining": 18
}/v1/keysCreates a key. The full hz_live_… secret is returned once — store it securely. List with GET /v1/keys; revoke with DELETE /v1/keys/:id.
curl -s https://hashzyn.onrender.com/v1/keys \
-H "Authorization: Bearer <session_or_key>" \
-H "Content-Type: application/json" \
-d '{"name":"ci"}'Ejemplo de respuesta
{
"id": "key_…",
"name": "ci",
"prefix": "hz_live_abcd1234",
"key": "hz_live_…full_secret_once…"
}/healthComprobación de vida para monitores.
curl -s https://hashzyn.onrender.com/health
401 — Bearer / clave API ausente o inválida.402 — Límite diario gratis o créditos agotados.429 — Tope IP — reintenta tras una breve espera.400 — Cuerpo inválido (hash, URL o archivo).Un crédito = un análisis de archivo/URL no cacheado. Caché y reputación pública no consumen créditos.