Enlaces compartidos

Riversoft® STCP DirectLink puede entregar un archivo a un destinatario mediante un enlace seguro, sin que este inicie una sesión. GET /download procesa el enlace, que puede requerir un PIN.

    sequenceDiagram
    participant C as Cliente
    participant A as Riversoft STCP DirectLink API
    participant D as Destinatario
    C->>A: GET enlace seguro de /download/pin
    A-->>D: Notificación con el PIN
    A-->>C: 200 OK con linkURL para /download
    D->>A: GET linkURL con p=PIN
    A-->>D: Contenido del archivo

Descargar mediante enlace seguro

Abra el enlace completo recibido. Ya contiene los parámetros que identifican el archivo, el usuario y el plazo de validez.

De forma predeterminada, el enlace de descarga es válido durante 24 horas y el PIN durante 180 segundos. El administrador del entorno puede cambiar estos plazos.

Envíe el PIN en el parámetro p:

export SECURE_DOWNLOAD_URL='<enlace completo recibido para /download>'
read -r -s -p 'PIN de la descarga: ' DOWNLOAD_PIN; printf '\n'

curl -L --fail -G \
  --data-urlencode "p=$DOWNLOAD_PIN" \
  --output ./archivo-descargado \
  "$SECURE_DOWNLOAD_URL"

Solicitar el envío del PIN

GET /download/pin inicia la entrega protegida por PIN a partir de un enlace seguro emitido por el servicio. La API:

genera un PIN;
envía el PIN al destinatario configurado;
devuelve un linkURL para continuar en /download.

export DOWNLOAD_PIN_REQUEST_URL='<enlace seguro emitido para iniciar el envío con PIN>'
curl -i "$DOWNLOAD_PIN_REQUEST_URL"

Respuesta:

{
  "status": 0,
  "description": "<descripción devuelta por la API>",
  "apiver": "v2 (9.0.1)",
  "email": "<correo electrónico del destinatario>",
  "phone": "<teléfono del destinatario>",
  "file": "<nombre del archivo>",
  "linkURL": "<enlace seguro para la descarga>",
  "time": "<fecha y hora>"
}

Con el PIN recibido, el destinatario sigue el linkURL como en Descargar mediante enlace seguro.

Atención

Los enlaces seguros tienen validez y están vinculados al archivo y al destinatario. No construya ni modifique sus parámetros firmados, y reenvíelos solo al destinatario autorizado.

Contrato completo en Referencia: Transferencias.

Recibir archivos Consultar informes