Cómo forzar tipos de datos en solicitudes Multipart

En determinados escenarios de integración en Skyone Studio, el sistema puede identificar erróneamente el formato de un parámetro. Por ejemplo, una contraseña de texto plano puede ser interpretada como un dato binario y convertida automáticamente a Base64. Este comportamiento resulta en fallas de autenticación o corrupción de archivos en la API receptora. El uso de comandos de "fuerza" garantiza que el dato sea transmitido exactamente en el formato esperado.

Concepto

Existen dos recursos fundamentales para el control de tipado en Skyone Studio:

• Sufijo de Tipo (:-text): Instrucciones adjuntas a la clave del parámetro que obligan al sistema a tratar el valor como texto puro.

• Parámetro de Fuerza ([STUDIO_FORCE_BASE64]): Un prefijo utilizado en el campo de valor que asegura el tratamiento del dato específicamente como Base64.

Cómo utilizar

1. Cree o edite un módulo hasta la etapa de Solicitud.

2. En el campo destinado al nombre del parámetro (Key), agregue el sufijo: -text después del nombre.

Ejemplo: En el campo de clave, en lugar de solo password, use password:-text

1. Configure el Valor Base64: Para campos que exigen estrictamente el formato Base64, inserte el prefijo [STUDIO_FORCE_BASE64] antes de la variable o valor.

2. Ejecute una prueba para verificar si la API de destino recibe los datos en el formato correcto.

Ejemplo

La siguiente tabla ilustra la configuración correcta tal como se visualiza en la interfaz de la plataforma:

Parámetro (Key)	Valor (Value)	Objetivo
code:-text	{{code}}	Fuerza a que el código sea enviado como texto.
base64	[STUDIO_FORCE_BASE64] {{base64}}	Garantiza la conversión/tratamiento en Base64.

Alerta: La detección automática de Base64 por parte de Skyone Studio se basa en patrones de caracteres. Si su cadena de texto coincide con estos patrones, la conversión ocurrirá obligatoriamente a menos que se utilice el sufijo :-text.

Importante: Estos parámetros son esenciales para integraciones que involucran el envío de credenciales o archivos binarios a través de formularios multipart.