Codificação Base64 e APIs¶

Base64 é uma forma de codificar dados binários em um conjunto de caracteres ASCII conhecido pela maioria dos sistemas de computador, a fim de transmitir dados sem perda ou modificação do próprio conteúdo. O termo Base64 origina-se de uma codificação específica de transferência de conteúdo MIME. Esquemas de codificação Base64 são comumente usados quando há necessidade de codificar dados binários que precisam ser armazenados e transferidos por meio de mídia projetada para lidar com dados textuais. A codificação Base64 pode ser usada para muitos arquivos e tipos de dados diferentes sendo transferidos, incluindo (mas não limitado a): PDFs, XLS, DOC, TXT, JPG, PNG, GIF, etc.

Por Que Usar a Codificação Base64 ?¶

A codificação Base64 é útil porque geralmente você pode contar com os mesmos 64 caracteres presentes em muitos conjuntos de caracteres e pode estar razoavelmente confiante de que seus dados terminarão no outro lado da linha sem corrupção.

No Vinyl, a codificação Base64 é usada para armazenar chaves de API do Vinyl e também pode ser usada para transferir e armazenar arquivos trocados por APIs. Lembre-se sempre de codificar sua string Base64 no formato UTF-8. Como não existe um padrão de API único, você deve verificar a documentação da API com a qual está trabalhando para determinar se os arquivos devem ser transportados com codificação Base64.

Chaves de API de Vinyl e Codificação Base64¶

Ao trabalhar com chaves de API do Vinyl para autenticação, elas assumem a forma de número inteiro de 128 bits codificado em URL Base64. Por exemplo: DLOo9sPS5slJEMHpXBFt3g.

A aplicação mais comum é para cabeçalhos de autenticação HTTP, onde o nome de usuário e a senha são combinados e codificados para produzir um 'token'. Esse token é passado para um endpoint HTTP para autorizar a solicitação.

Para obter mais informações sobre como configurar a autenticação de chave API no Vinyl, consulte Chave API.

Como Codificar e Decodificar Arquivos De/para Base64¶

Se você precisar codificar ou decodificar manualmente em Base64, existem muitos utilitários on-line que fornecem conversões para arquivos ou informações de string. Aqui está um utilitário online que oferece codificação e decodificação:

https://www.base64decode.org/

É possível codificar e decodificar dados em Base64 sem usar um utilitário online. Você poderia, por exemplo, usar prompts de linha de comando e sintaxe adequada para realizar a transformação de dados.

Utilitários SQL Server Base64¶

O próprio SQL Server possui suporte integrado para codificação e decodificação de arquivos Base64.

Atalho de Vinyl para Renderizar Foto de Coluna Binária em um Email Como Imagem¶

Todos os dados de mensagens de correio transmitidos pela Internet são traduzidos como Base64. Aqui está um atalho útil para renderizar uma foto de coluna binária em um Email como uma imagem:

Você pode codificar em Base64 a coluna binária usando SQL de escape e inserir a string codificada em Base64 em uma coluna. Por exemplo:

${cast('' as xml).value('xs:base64Binary(sql:column("ECL.Photo"))', 'varbinary(max)')}

Em seguida, você pode adicionar qualquer formatação de imagem ao seu modelo de workflow como CSS embutido. Por exemplo:

<img src="data:image/png;base64,{{Foto}}"  width="20%" style="display: block; margin: 0 auto;">

Recursos¶

Para obter mais informações, consulte o artigo Mozilla.org Codificação e decodificação Base64