Skip to content

Documentos firmados

Cómo emitir, entregar, mostrar y verificar un documento firmado: una constancia que firmás vos, queda anclada on-chain y cualquiera puede comprobar.

Un documento firmado es una credencial sin holder: vos lo firmás y lo entregás. No hay wallet ni flujo de aceptación. Una sola llamada valida los datos, los firma y ancla la firma on-chain (la registra en SovraChain). El resultado es un string, el credential, que cualquiera puede verificar contra la cadena sin depender de Sovra.

Si lo que necesitás es una credencial que viva en la wallet de una persona, andá a Credenciales. La comparación entre los dos está en Documentos firmados.

El flujo de punta a punta

sequenceDiagram
    autonumber
    participant S as Tu servidor
    participant API as API de Sovra
    participant C as SovraChain
    participant D as Destinatario

    S->>API: POST /api/v1/issuer/documents
    API-->>S: 201 status signed + credential
    API->>C: Ancla la firma
    API-->>S: Webhook document.status-changed (anchored)
    S-->>D: Entrega el credential o un enlace público
    D->>C: Verifica firma, emisor y anclaje

El mismo flujo con curl:

export BASE_URL="https://test-api-sovra.flagonsa.com"
export SOVRA_API_KEY="sovra_sk_..."

# 1. Emitir: valida, firma y responde enseguida con status "signed".
curl -s -X POST "$BASE_URL/api/v1/issuer/documents" \
  -H "Authorization: Bearer $SOVRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "schema_id": "document_example",
    "claims": { "date": "20-08-2026", "idDocument": 1234567,
                "content": "Contenido de Prueba", "isConfidential": false }
  }'
# Guardá `credential`: ese string ES el documento.

# 2. Esperar el webhook document.status-changed con status "anchored".

# 3. (Opcional) Publicarlo para compartir un enlace. Todo documento nace privado.
curl -s -X PUT -H "Authorization: Bearer $SOVRA_API_KEY" \
  "$BASE_URL/api/v1/issuer/documents/$DOCUMENT_ID/visibility/public"

# 4. El destinatario lo lee sin API key, y lo verifica contra la cadena.
curl -s "$BASE_URL/api/v1/documents/$DOCUMENT_ID"

Cuatro cosas para saber antes de integrar

  1. Guardá credential. Es el documento. El resto de la respuesta se puede volver a pedir.
  2. El anclaje tarda. La emisión responde con status: "signed", y un verificador rechaza todo lo que no esté anchored. Entregá cuando llegue el webhook document.status-changed.
  3. Todo documento nace privado. Volverlo privado cierra el enlace, pero no las copias ya entregadas.
  4. No hay endpoint de verificación, a propósito. Un veredicto habría que creerlo; una firma se puede comprobar.

Las páginas de esta sección

Recursos

  • Colección de Postman: importala y configurá base_url, api_key y schema_id. Más detalle en Emitir.
  • Especificación OpenAPI en vivo: GET {baseUrl}/openapi/api.
  • Boilerplate de renderizado document-render-boilerplate: dibuja la hoja A4 a partir del JSON público. Ver Renderizado.

Type to search…

↑↓ navigate↵ selectEsc close