Sygnet — API

Registra un certificado SIA. Si el hash ya está activo, devuelve OK sin duplicar. Registers a SIA certificate. If the hash is already active, returns OK without duplicating.

Body JSON

{
  "hash":        "<SHA3-512 hex, 128 chars>",  // obligatoriorequired
  "algorithm":   "SHA3-512",                     // SHA3-512 (defectodefault) | SHA256
  "sia_level":   1,                              // 1-5 (1=100% humanohuman, 5=100% IAAI)
  "description": "Informe Q2 2026Report Q2 2026",              // opcional, máx 500 charsoptional, max 500 chars
  "file_size":   204800,                         // tamaño en bytessize in bytes
  "expires_at":  1782000000                      // timestamp Unix UTC de caducidadUnix UTC expiry timestamp
}

Respuesta (siempre HTTP 200)Response (always HTTP 200)

{"ok": true, "hash": "<hash>", "new": true}
// si el hash ya estaba activoif the hash was already active:
{"ok": true, "hash": "<hash>", "new": false, "own": true}

El hash SHA3-512 debe calcularse en el cliente antes de llamar a la API. La API nunca recibe el archivo, solo el hash. The SHA3-512 hash must be computed on the client before calling the API. The API never receives the file, only the hash.

Verifica un certificado. Público — no requiere autenticación. Verifies a certificate. Public — no authentication required.

RespuestaResponse

{
  "ok": true,
  "certificate": {
    "file_hash":          "abc123...",
    "status":             "active",         // active | expired | revoked | renewed
    "sia_level":          1,
    "description":        "Informe Q2Report Q2",
    "uploaded_at":        "2026-06-06T10:00:00",
    "caduca_at":          "2027-06-06T10:00:00",
    "verification_count": 12,
    "owner":              "u-a3f9b2c1d4e5",  // pseudónimo GDPRGDPR pseudonym
    "votes": {
      "total":   5,
      "by_type": {"endorse": 4, "dissent": 1, "dispute": 0},
      "user_vote": null
    }
  }
}

Devuelve un badge SVG 220×26px coloreado por nivel SIA. Embebible como <img> en cualquier web. Returns a 220×26px SVG badge coloured by SIA level. Embeddable as <img> in any website.

<img src="https://mysygnet.com/api/certificados/abc123.../badge"
     alt="Sygnet certificadoSygnet certificate">

Payload que recibirás Payload you will receive

{
  "event":         "cert.created",
  "hash":          "abc123...",
  "sia_level":     1,
  "description":   "Informe Q2 2026Report Q2 2026",
  "caduca_at":     "2027-06-06T10:00:00",
  "issued_at":     "2026-06-06T10:00:00Z",
  "published_url": null,
  "content_type":  null
}

Chorus con bridging

Las notas solo se hacen visibles (y penalizan −8 pts) cuando tanto fans como desconocidos del creador las votan útiles. Esto evita que lobbies coordinen ataques o defensas. Notes only become visible (and penalize −8 pts) when both fans and strangers to the creator vote them as helpful. This prevents lobbies from coordinating attacks or defenses.

Crea una entrada Chorus. Requiere: cuenta ≥ 7 días, cert propio ≥ 30 días, Prestigio ≥ 5 pts. Máx 1 entrada por usuario por cert. Creates a Chorus entry. Requires: account ≥ 7 days, own cert ≥ 30 days, Prestige ≥ 5 pts. Max 1 entry per user per cert.

{ "reason": "SIA_INCORRECTO" | "AUTORIA_DUDOSA", "body": "textotext (1-280 chars)" }

{"ok": true, "note_id": 42}

Lista notas públicas (quarantine + visible). Con JWT incluye user_has_cert, is_own, can_rate, can_vote_dispute. Lists public notes (quarantine + visible). With JWT includes user_has_cert, is_own, can_rate, can_vote_dispute.

Valora una nota en cuarentena. Rate: 20/h. Desencadena el algoritmo bridge. Rates a note in quarantine. Rate: 20/h. Triggers the bridge algorithm.

{ "rating": "util" | "no_util" }

Vota en una disputa activa. Requiere Prestigio ≥ 15 (o ≥ 5 si bootstrap_mode=true) + cuenta ≥ 30 días. Votación disponible 48 h después del inicio de la disputa. Votes in an active dispute. Requires Prestige ≥ 15 (or ≥ 5 if bootstrap_mode=true) + account ≥ 30 days. Voting available 48 h after dispute start.

{ "side": "mantener" | "rechazar" }

Ofrecerse como mediador en disputas de contenido privado (sin URL publicada). Requiere Prestigio ≥ 30, idioma común con el propietario, sin endorsements cruzados con ninguna parte en 90 días. Volunteer as mediator in private content disputes (no published URL). Requires Prestige ≥ 30, shared language with owner, no cross-endorsements with any party in 90 days.

Lista todas las disputas activas. Público. Con JWT incluye user_is_creator, user_is_author, user_is_mediator, mediators (lista de candidatos, solo para las partes). Lists all active disputes. Public. With JWT includes user_is_creator, user_is_author, user_is_mediator, mediators (candidate list, parties only).

Reporta el enlace publicado de un certificado como roto. El creador tiene 7 días para arreglarlo antes de que aparezca una nota automática. Rate: 5/h. Solo para certs con published_url. Reports the published link of a certificate as broken. The creator has 7 days to fix it before an automatic note appears. Rate: 5/h. Only for certs with published_url.

Notificaciones del usuario autenticado (JWT). Paginado: ?offset=0&limit=20. Las no leídas aparecen primero. Notifications for the authenticated user (JWT). Paginated: ?offset=0&limit=20. Unread items appear first.

GET /api/user/notifications/count  →  {"ok": true, "unread": 3}

POST /api/user/notifications/read
{ "ids": [1, 2] }  // vacío = marcar todas// empty = mark all