Transferencias
Guías relacionadas: Enviar archivos, Recibir archivos y Enlaces compartidos.
POST /upload
Recibe un archivo del usuario autenticado.
Acceso: sesión (token Bearer o cookie).
Cuerpo: multipart/form-data o application/octet-stream.
Campos de multipart/form-data:
| Campo | Obligatorio | Descripción |
|---|---|---|
file | Sí | Contenido del archivo. |
d | No | Destinatario o usuario de destino. |
m | No | Correo electrónico asociado a la transferencia. |
c | No | Teléfono móvil asociado a la transferencia. |
h | No | Hash SHA-256 esperado del archivo. |
n | No | Identificación o correo electrónico del remitente. |
i | No | Información adicional o etiquetas de la transferencia. |
Cabeceras de application/octet-stream (archivo en el cuerpo sin procesar):
| Cabecera | Obligatoria | Equivale a |
|---|---|---|
X-STCPDIRECTLINK-FILENAME | Sí | Nombre del archivo |
X-STCPDIRECTLINK-DESTINATION | No | d |
X-STCPDIRECTLINK-EMAIL | No | m |
X-STCPDIRECTLINK-MOBILE | No | c |
X-STCPDIRECTLINK-HASH | No | h |
X-STCPDIRECTLINK-EMAIL-FROM | No | n |
X-STCPDIRECTLINK-INFO | No | i |
Respuestas
| HTTP | Significado | Cuerpo |
|---|---|---|
200 | Archivo recibido. | UploadResponse |
400 | Solicitud o parámetro no válido. | — |
401 | Credencial no aceptada. | — |
403 | Operación no permitida por las reglas del usuario o del entorno. | — |
POST /directlink/v2/upload HTTP/1.1
Host: api.ejemplo.com
Authorization: Bearer <access_token>
Content-Type: application/octet-stream
X-STCPDIRECTLINK-FILENAME: documento.pdf
X-STCPDIRECTLINK-DESTINATION: <destino>
<bytes-del-archivo>GET /download/list y /download/list/backup
Listan los archivos disponibles para el usuario en el área principal (/download/list) o en el área de respaldo (/download/list/backup).
Acceso: sesión (token Bearer o cookie).
| Parámetro | Ubicación | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
page | query | No | 0 | Página de resultados. Los valores ausentes o no válidos se tratan como 0. |
Respuestas
| HTTP | Significado | Cuerpo |
|---|---|---|
200 | Lista de archivos. | FileListResponse |
401 | Credencial no aceptada. | — |
El listado principal devuelve enlaces a /download/file; el de respaldo, a /download/file/backup.
GET /download/file y /download/file/backup
Descargan un archivo listado. Se llaman mediante el linkURL del listado.
Acceso: enlace seguro y token Bearer (en el header Authorization o en la cookie de sesión) del mismo usuario que hizo el listado. El enlace solo no da acceso al archivo.
Respuestas
| HTTP | Significado | Cuerpo |
|---|---|---|
200 | Contenido del archivo. | application/octet-stream |
400 | Credencial ausente. | — |
401 | Token inválido o vencido. | — |
403 | El token es de otro usuario, la descarga está deshabilitada o el acceso fue bloqueado. | — |
404 | Archivo o enlace no encontrado. | — |
Headers de la respuesta
| Header | Descripción |
|---|---|
Content-Type | Tipo MIME deducido de la extensión del archivo; application/octet-stream cuando es desconocido. |
Content-Disposition | attachment; filename="<nombre-del-archivo>". |
Content-Length | Tamaño del archivo, en bytes. |
X-STCPDIRECTLINK-HASH | Hash SHA-256 informado en la carga del archivo (vacío cuando no se informó). |
GET /download
Entrega un archivo a partir de un enlace seguro compartido.
Acceso: enlace seguro.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
p | query | Cuando el enlace lo requiera | PIN de la descarga. Los demás parámetros vienen en el enlace y no deben modificarse. |
Respuestas
| HTTP | Significado | Cuerpo |
|---|---|---|
200 | Contenido del archivo. | application/octet-stream |
404 | Archivo o enlace no encontrado. | — |
Los headers de la respuesta son los mismos de /download/file.
GET /download/pin
Genera un PIN, lo envía al destinatario configurado y devuelve el enlace para continuar en /download.
Acceso: enlace seguro emitido por el servicio para iniciar el envío del PIN.
Respuestas
| HTTP | Significado | Cuerpo |
|---|---|---|
200 | PIN enviado; la respuesta contiene el enlace de descarga. | DownloadPinResponse |