Preguntas frecuentes
¿Cuál es la diferencia entre /auth/token y /oauth2/token?
Ninguna. Las dos rutas reciben el mismo formulario y devuelven la misma respuesta. Use la que prefiera.
¿Debo usar el inicio de sesión local o un token OAuth?
Para integraciones de sistema a sistema, use el password grant: devuelve un token Bearer en el JSON. El inicio de sesión local reproduce el inicio de sesión del usuario, con MFA, y entrega la sesión en una cookie.
¿Durante cuánto tiempo es válido el token?
Durante el número de segundos informado en expires_in. El valor depende de la configuración del entorno.
¿El campo scope indica los permisos del token?
No. scope contiene la URI de la API configurada en el entorno. Los permisos los definen las reglas del usuario en el entorno.
¿La API acepta JSON en el cuerpo de las solicitudes?
No. Los endpoints reciben application/x-www-form-urlencoded, multipart/form-data o application/octet-stream. Las respuestas son JSON, excepto en las descargas.
¿Puedo construir la URL de descarga a partir del id del archivo?
No. Use siempre el linkURL devuelto por el listado. Contiene parámetros firmados que autorizan la descarga.
¿El destinatario de un enlace compartido necesita usuario y contraseña?
No. El enlace seguro autoriza la descarga; el destinatario puede necesitar solo el PIN. Consulte Enlaces compartidos.
¿Cómo verifico que el archivo llegó íntegro?
Informe el hash en el envío (campo h o cabecera X-STCPDIRECTLINK-HASH) y compare el length de la respuesta con el tamaño del archivo. Consulte Enviar archivos.
¿Dónde encuentro la especificación OpenAPI?
En Especificación OpenAPI, en portugués, inglés y español.