Como forçar tipos de dados em requisições Multipart

Em determinados cenários de integração no Skyone Studio, o sistema pode identificar erroneamente o formato de um parâmetro. Por exemplo, uma senha de texto simples pode ser interpretada como um dado binário e convertida automaticamente para Base64. Esse comportamento resulta em falhas de autenticação ou corrupção de arquivos na API receptora. O uso de comandos de "força" garante que o dado seja transmitido exatamente no formato esperado.

Conceito

Existem dois recursos fundamentais para o controle de tipagem no Skyone Studio:

• Sufixo de Tipo (:-text): Instruções anexadas à chave do parâmetro que obrigam o sistema a tratar o valor como texto puro.

• Parâmetro de Força ([STUDIO_FORCE_BASE64]): Um prefixo utilizado no campo de valor que assegura o tratamento do dado especificamente como Base64.

Como utilizar

1. Crie ou edite um módulo até a etapa de Requisição.

2. No campo destinado ao nome do parâmetro (Key), adicione o sufixo :-text após o nome.

Exemplo: No campo de chave, em vez de apenas password, utilize password:-text.

1. Configure o Valor Base64: Para campos que exigem estritamente o formato Base64, insira o prefixo [STUDIO_FORCE_BASE64] antes da variável ou valor.

2. Execute um teste para verificar se a API de destino recebe os dados no formato correto.

Exemplo

A tabela abaixo ilustra a configuração correta conforme visualizado na interface da plataforma:

Parâmetro (Key)	Valor (Value)	Objetivo
code:-text	{{code}}	Força o código a ser enviado como texto.
base64	[STUDIO_FORCE_BASE64] {{base64}}	Garante a conversão/tratamento em Base64.

Alerta: A detecção automática de Base64 pela Skyone Studio baseia-se em padrões de caracteres. Se sua string de texto coincidir com esses padrões, a conversão ocorrerá obrigatoriamente a menos que o sufixo :-text seja utilizado.

Importante: Estes parâmetros são essenciais para integrações que envolvem o envio de credenciais ou arquivos binários via formulários multipart.