Editar un firmante

POST
/api/{firmamexId}/signer/{publicSignerId}/update

Corrige los datos de un firmante antes de que haya firmado — un correo mal escrito, el dato de verificación equivocado, o un cambio de autoridad. Una vez que ese firmante firmó, su recuadro queda fijo.

Necesitas dos ids, los dos los devuelve POST /developers/json: el document_ticket del documento y el sticker_id del firmante.

Este endpoint es un POST.

Autenticación

signmage
Authorization<token>

Cada petición lleva Authorization: signmage {webId}:{firma}, donde firma es el Base64 de HMAC-SHA256(apiKey, cadenaFirmada).

Qué va dentro de cadenaFirmada depende de la petición:

PeticióncadenaFirmada
GETLa URI completa incluyendo el query string, exactamente como se envía
POST con JSONEl cuerpo JSON, re-serializado compacto (sin espacios ni salto de línea final)
POST multipartEl SHA-256 en Base64 del archivo, que además se manda en el header Content-SHA256

Dos detalles que conviene resolverlos desde el principio:

  1. En GET, la URI se firma tal como se envía, así que el orden y el encoding de los parámetros importan.
  2. En POST, la comparación se hace contra tu JSON re-serializado en forma compacta. Manda JSON compacto y canónico para que las firmas coincidan.

Una firma que no coincide devuelve 401 con el cuerpo vacío. Como la misma respuesta cubre un web ID desconocido, una llave inactiva y una firma que no coincide, revisa las tres cosas al diagnosticar.

En: header

Parámetros de ruta

firmamexId*string

El id del documento (document_ticket).

publicSignerId*string

El sticker_id del firmante.

Cuerpo de la petición

application/json

Definiciones de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

text/plain

curl -X POST "https://example.com/api/string/signer/2Vxy55zxo/update" \  -H "Content-Type: application/json" \  -d '{    "authority": "EMAIL_LINK",    "email": "[email protected]",    "data": "[email protected]",    "imageType": "desc"  }'

{  "status": "success"}