Redistribuir un sobre

URL base: https://business.digito.do/api/v2.

EjemplosCopiar link al encabezado

Configura DIGITO_API_TOKEN en el servidor. Sustituye los IDs y archivos de ejemplo por los de tu equipo. TypeScript usa fetch y FormData de Node.js.

curl --fail-with-body \
  --request POST \
  --url 'https://business.digito.do/api/v2/envelope/redistribute' \
  --header "Authorization: $DIGITO_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "envelopeId": "sobre_de_ejemplo",
  "recipients": [
    501
  ]
}
JSON

AutenticaciónCopiar link al encabezado

Envía el token de la API en el encabezado Authorization. El acceso corresponde al equipo y a los permisos del token. Conserva el token en tu servidor.

Authorization: api_TU_TOKEN

Antes de cada acción de firma, el firmante debe autenticarse de nuevo con Digito ID. Una sesión previa de Business, un token de destinatario o un token de la API no sustituye este requisito.

ParámetrosCopiar link al encabezado

Esta operación no declara parámetros de ruta ni de consulta.

Cuerpo de la solicitudCopiar link al encabezado

El cuerpo es obligatorio.

Tipo de contenido: application/json.

Objeto de ejemploCopiar link al encabezado

{
  "envelopeId": "sobre_de_ejemplo",
  "recipients": [
    501
  ]
}

Los valores muestran una solicitud posible; no son valores predeterminados del servidor.

{
  "type": "object",
  "properties": {
    "envelopeId": {
      "type": "string"
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 1
    }
  },
  "required": [
    "envelopeId",
    "recipients"
  ]
}

Respuesta de éxitoCopiar link al encabezado

signingUrl representa la URL que devuelve la API. Usa ese valor directamente; no construyas una ruta a partir del token. El marcador del ejemplo no es un link de firma.

Este objeto sintético ilustra la estructura completa de una respuesta 200. Los identificadores, fechas, estados y tokens son datos de ejemplo.

{
  "success": true,
  "id": "sobre_de_ejemplo",
  "recipients": [
    {
      "id": 501,
      "name": "Ana Ejemplo",
      "email": "ana@example.com",
      "token": "token_de_destinatario_ejemplo",
      "role": "SIGNER",
      "signingOrder": null,
      "signingUrl": "URL_DE_FIRMA_DEVUELTA_POR_LA_API"
    }
  ]
}

Respuestas y erroresCopiar link al encabezado

Los esquemas enlazados incluyen propiedades anidadas, campos obligatorios, variantes, enumeraciones, nulabilidad y restricciones. Consulta errores y reintentos para manejar respuestas no exitosas.

Identificador de operación: envelope-redistribute.