Sygnet — Automatización para creadores Sygnet — Automation for creators

Python 3.6+

import hashlib

def hash_file(path: str) -> str:
    """SHA3-512 of a file, memory-efficient (64 KB chunks)."""
    h = hashlib.sha3_512()
    with open(path, 'rb') as f:
        for chunk in iter(lambda: f.read(65536), b''):
            h.update(chunk)
    return h.hexdigest()

# Usage
print(hash_file("my-article.pdf"))
# → "a1b2c3d4e5f6..."  (128 chars)

No necesita dependencias externas. hashlib es librería estándar de Python. No external dependencies. hashlib is Python's standard library.

Node.js

// Option A — js-sha3 (compatible with all Node versions)
// npm install js-sha3
const { sha3_512 } = require('js-sha3');
const fs           = require('fs');

function hashFile(path) {
    return sha3_512(fs.readFileSync(path));
}

// Option B — native crypto (Node 21+ / OpenSSL 3+)
const crypto = require('crypto');
const fs     = require('fs');

function hashFile(path) {
    return crypto.createHash('sha3-512')
        .update(fs.readFileSync(path))
        .digest('hex');
}

Usa la opción A si necesitas compatibilidad amplia. La opción B no requiere dependencias pero solo funciona en Node.js 21+. Use option A for broad compatibility. Option B requires no dependencies but only works on Node.js 21+.

Línea de comandosCommand line

# Python — works on any system with Python 3.6+
python3 -c "
import hashlib, sys
h = hashlib.sha3_512()
[h.update(c) for c in iter(lambda: open(sys.argv[1],'rb').read(65536), b'')]
print(h.hexdigest())
" my-file.pdf

# OpenSSL 3+ (Linux / macOS Ventura+)
openssl dgst -sha3-512 my-file.pdf | awk '{print $2}'

Python — requests

import requests

def certificar(hash_: str, titulo: str, sia: int = 1, published_url: str = None) -> dict:
    payload = {
        "hash":        hash_,
        "algorithm":   "SHA3-512",
        "sia_level":   sia,
        "description": titulo,
    }
    if published_url:
        payload["published_url"] = published_url

    r = requests.post(
        "https://mysygnet.com/api/certificados",
        headers={"Authorization": "Bearer apikey_YOUR_KEY"},
        json=payload,
        timeout=15
    )
    r.raise_for_status()
    return r.json()

Todas las URLs, a partir del hash All URLs, from the hash

HASH = "a1b2c3d4..."  # 128 chars you computed

# Badge SVG (embeddable as <img>, updates in real time)
badge_url   = f"https://mysygnet.com/api/certificados/{HASH}/badge"

# Interactive widget (iframe, dark card 300×100px, click → verify)
widget_url  = f"https://mysygnet.com/pages/widget.html?hash={HASH}"

# OBS Browser Source (transparent background, auto-refresh 60s)
overlay_url = f"https://mysygnet.com/pages/overlay.html?hash={HASH}"

# Raw JSON API — for scripts/monitoring, NOT for sharing with humans
api_url     = f"https://mysygnet.com/api/certificados/{HASH}"

# Certificate PDF (downloadable)
pdf_url     = f"https://mysygnet.com/api/certificados/{HASH}/pdf"

# Iframe snippet ready to paste on your site
iframe = (
    f'<iframe src="{widget_url}" width="300" height="100" '
    f'frameborder="0" scrolling="no" '
    f'style="border:none;overflow:hidden;border-radius:12px"></iframe>'
)

Python — pipeline completo Python — full pipeline

Certifica un archivo y devuelve todas las URLs listas para usar. Certify a file and return all ready-to-use URLs.

import hashlib
import json
import base64
import requests

SYGNET_API_KEY = "apikey_YOUR_KEY"
BASE            = "https://mysygnet.com"


def hash_file(path: str) -> str:
    h = hashlib.sha3_512()
    with open(path, 'rb') as f:
        for chunk in iter(lambda: f.read(65536), b''):
            h.update(chunk)
    return h.hexdigest()


def certificar_y_badge(
    file_path: str,
    titulo: str,
    sia: int = 1,
    published_url: str = None,
    lang: str = "en"
) -> dict:
    """
    Certify a file and return hash + all useful URLs.
    sia: 1=100% human  2=human+AI  3=co-authored  4=mainly AI  5=100% AI
    """
    hash_ = hash_file(file_path)

    payload = {
        "hash":        hash_,
        "algorithm":   "SHA3-512",
        "sia_level":   sia,
        "description": titulo,
    }
    if published_url:
        payload["published_url"] = published_url

    r = requests.post(
        f"{BASE}/api/certificados",
        headers={"Authorization": f"Bearer {SYGNET_API_KEY}"},
        json=payload,
        timeout=15
    )
    r.raise_for_status()

    widget_url  = f"{BASE}/pages/widget.html?hash={hash_}&lang={lang}"
    overlay_url = f"{BASE}/pages/overlay.html?hash={hash_}&lang={lang}"
    iframe      = (
        f'<iframe src="{widget_url}" width="300" height="100" '
        f'frameborder="0" scrolling="no" '
        f'style="border:none;overflow:hidden;border-radius:12px"></iframe>'
    )
    badge_img   = f'<img src="{BASE}/api/certificados/{hash_}/badge" alt="Sygnet SIA certificate">'

    # Human-readable page to share with your audience (YouTube description, bio, post)
    share_payload = {"h": hash_, "s": sia, "l": titulo}
    share_b64     = base64.b64encode(json.dumps(share_payload, separators=(",", ":")).encode()).decode()
    share_url     = f"{BASE}/?cert={share_b64}"

    return {
        "hash":        hash_,
        "widget_url":  widget_url,
        "overlay_url": overlay_url,
        "iframe":      iframe,
        "badge_img":   badge_img,
        "share_url":   share_url,                        # for humans — paste this on YouTube/bio/posts
        "api_url":     f"{BASE}/api/certificados/{hash_}",  # raw JSON — for scripts/monitoring only
        "pdf_url":     f"{BASE}/api/certificados/{hash_}/pdf",
    }


# ── Example usage ─────────────────────────────────────────────────────────────

cert = certificar_y_badge(
    file_path     = "episode-42.mp4",
    titulo        = "Episode 42: The future of AI",
    sia           = 1,                                         # 100% human
    published_url = "https://www.youtube.com/watch?v=XXXX",
    lang          = "en"
)

print(f"Hash: {cert['hash'][:16]}…")
print(f"Share with your audience: {cert['share_url']}")
print()
print("Paste this on your site:")
print(cert['iframe'])
print()
print("For GitHub README (no iframes allowed):")
print(cert['badge_img'])

Ejemplo: worker que recibe el webhook y actualiza el CMS Example: worker that receives the webhook and updates the CMS

Flask. Para más detalle sobre la verificación HMAC, ver laFor more on HMAC verification, see the Guía de webhooksWebhooks Guide .

import hmac, hashlib, json
from flask import Flask, request, abort

app    = Flask(__name__)
SECRET = "your_webhook_secret"
BASE   = "https://mysygnet.com"

@app.route("/sygnet-webhook", methods=["POST"])
def recibir():
    body  = request.get_data()
    firma = request.headers.get("X-Sygnet-Signature", "")
    esp   = "sha256=" + hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()

    if not hmac.compare_digest(esp, firma):
        abort(401)

    evento = json.loads(body)
    hash_  = evento["hash"]

    # Widget URL is deterministic — no extra API call needed
    widget_url  = f"{BASE}/pages/widget.html?hash={hash_}"
    overlay_url = f"{BASE}/pages/overlay.html?hash={hash_}"
    iframe      = (
        f'<iframe src="{widget_url}" width="300" height="100" '
        f'frameborder="0" scrolling="no" '
        f'style="border:none;overflow:hidden;border-radius:12px"></iframe>'
    )

    # Update your CMS / database with the iframe
    actualizar_cms(evento["description"], iframe)

    return "", 200

def actualizar_cms(titulo, iframe_html):
    # Your logic: Ghost API, WordPress API, Webflow CMS, etc.
    print(f"Updating '{titulo}' with badge:\n{iframe_html}")

if __name__ == "__main__":
    app.run(port=5000)