Migración de la v1 a la v2
A partir de Riversoft® STCP DirectLink 9.0.1, la Riversoft STCP DirectLink API se atiende solo en la versión v2, con el prefijo /directlink/v2. La versión v1 ya no se atiende. Adecúe las integraciones antes de la actualización del entorno.
Qué cambia
| Cambio en la v2 | Qué hacer en la integración |
|---|---|
Prefijo /directlink/v2 en todas las rutas. | Cambie /directlink/v1 por /directlink/v2 en las URL. |
La carga, los listados, el informe y el logout exigen token Bearer, en el header Authorization o en la cookie de sesión. Basic se acepta solo en /auth/login. | Obtenga un token y envíe Authorization: Bearer <token>. Vea Autenticación. |
La descarga de un archivo listado (/download/file y /download/file/backup) exige el linkURL y el token Bearer o la cookie de sesión del mismo usuario que hizo el listado. | Envíe el mismo token del listado al descargar el archivo. Vea Recibir archivos. |
/auth/token y /oauth2/token son equivalentes y emiten tokens por password grant o token exchange, según los métodos habilitados en el entorno. | Confirme con el administrador los métodos habilitados. Para seguir OAuth 2.1, prefiera el token exchange. Vea Tokens OAuth. |
En el token exchange, el proveedor del JWT se informa en el campo provider o en el header X-STCPDIRECTLINK-JWT-ISSUER. | Informe el proveedor en cada solicitud de token. |
La sesión del portal y del SSO queda en la cookie segura __Host-dirl_session. El token ya no se entrega en la URL. | Use la sesión por cookie o un token obtenido en los endpoints de token. |
Las llamadas hechas por un host distinto del configurado se rechazan con 403. | Use la dirección configurada para la API. |
El campo time de las respuestas usa el formato ISO 8601 (RFC 3339), por ejemplo 2026-11-07T14:03:21-03:00. | Ajuste la lectura de ese campo. |
/auth/change acepta solo POST; los otros métodos reciben 405. | Envíe POST con p y z en el cuerpo del formulario, nunca en la URL. |
El campo apiver informa v2, por ejemplo v2 (9.0.1). | Ajuste las validaciones que verifican la versión. |
El enlace compartido (/download), entregado a terceros con o sin PIN, sigue funcionando sin token.
Cómo migrar
Releve las integraciones
Identifique los sistemas que llaman a la API, las rutas usadas y cómo se autentica hoy cada uno.
Cambie el prefijo
Cambie la URL base a https://{host}/directlink/v2.
Ajuste la autenticación
Obtenga un token por inicio de sesión, token exchange o password grant (cuando esté habilitado) y envíelo en todas las rutas protegidas, incluida la descarga por el linkURL.
Ajuste la lectura de las respuestas
Actualice la lectura de los campos time y apiver.
Pruebe en homologación
Pruebe el inicio de sesión, la carga, el listado y la descarga, el informe y el logout antes de la actualización del entorno de producción.
Checklist
- Todas las URL usan
/directlink/v2. - Todas las rutas protegidas envían el token Bearer o usan la cookie de sesión.
- La descarga por el
linkURLenvía el token del mismo usuario del listado. - El campo
timese lee en el formato ISO 8601. - Los métodos de autenticación usados están habilitados en el entorno.
- El host usado por los clientes es el configurado para la API.
Para el procedimiento de actualización del servidor, destinado a los administradores, vea Migración de la versión 8 a la versión 9.