Links compartilhados

O Riversoft® STCP DirectLink pode entregar um arquivo a um destinatário por um link seguro, sem que ele inicie uma sessão. O link é processado por GET /download e pode exigir um PIN.

    sequenceDiagram
    participant C as Cliente
    participant A as Riversoft STCP DirectLink API
    participant D as Destinatário
    C->>A: GET link seguro de /download/pin
    A-->>D: Notificação com o PIN
    A-->>C: 200 OK com linkURL para /download
    D->>A: GET linkURL com p=PIN
    A-->>D: Conteúdo do arquivo
  

Baixar por link seguro

Abra o link integral recebido. Ele já contém os parâmetros que identificam o arquivo, o usuário e o prazo de validade.

Por padrão, o link de download vale 24 horas e o PIN, 180 segundos. O administrador do ambiente pode alterar esses prazos.

export SECURE_DOWNLOAD_URL='<link integral recebido para /download>'
read -r -s -p 'PIN do download: ' DOWNLOAD_PIN; printf '\n'

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

export SECURE_DOWNLOAD_URL='<link integral recebido para /download>'

curl -L --fail \
  --output ./arquivo-baixado \
  "$SECURE_DOWNLOAD_URL"

Solicitar o envio do PIN

GET /download/pin inicia a entrega protegida por PIN a partir de um link seguro emitido pelo serviço. A API:

1. gera um PIN;
2. envia o PIN ao destinatário configurado;
3. devolve um linkURL para continuar em /download.

export DOWNLOAD_PIN_REQUEST_URL='<link seguro emitido para iniciar o envio com PIN>'
curl -i "$DOWNLOAD_PIN_REQUEST_URL"

Resposta:

{
  "status": 0,
  "description": "<descrição retornada pela API>",
  "apiver": "v2 (9.0.1)",
  "email": "<e-mail do destinatário>",
  "phone": "<telefone do destinatário>",
  "file": "<nome do arquivo>",
  "linkURL": "<link seguro para download>",
  "time": "<data e hora>"
}

Com o PIN recebido, o destinatário segue o linkURL como em Baixar por link seguro.

Contrato completo em Referência: Transferências.