For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Atualizado

Isto foi útil?