Documentation Index
Fetch the complete documentation index at: https://docs.datacrazy.io/llms.txt
Use this file to discover all available pages before exploring further.
A Conexão Universal oferece uma seção de Autenticação para adicionar headers de autenticação automaticamente, e uma seção de Credenciais para armazenar valores sensíveis como tokens e chaves de API.
Autenticação
Na seção Autenticação da aba Envio, selecione o Tipo de Autenticação no dropdown. As opções disponíveis são:
| Tipo | Descrição |
|---|
| Nenhuma | Sem autenticação automática |
| Bearer Token | Token Bearer no header Authorization |
| API Key | Chave de API em header customizável |
| Basic Auth | HTTP Basic Auth (usuário e senha em Base64) |
| Headers Customizados | Headers personalizados com interpolação de variáveis |
Nenhuma
Nenhum header de autenticação é adicionado automaticamente. Útil quando a autenticação é feita via URL (como no Telegram) ou quando o serviço não exige autenticação.
Bearer Token
Adiciona automaticamente o header Authorization: Bearer {token} em todas as requisições.
| Campo | Descrição |
|---|
| Chave do Bearer Token | Nome da credencial que contém o token (padrão: token) |
token, adicione uma credencial com o nome token e o valor do seu token.
Header gerado automaticamente:
Authorization: Bearer sk_live_abc123def456
API Key
Adiciona a chave de API em um header customizável.
| Campo | Descrição |
|---|
| Header da API Key | Nome do header que receberá a chave (padrão: X-API-Key) |
| Chave da API Key | Nome da credencial que contém o valor (padrão: apiKey) |
X-API-Key: minha-chave-secreta
Basic Auth
Adiciona o header Authorization com usuário e senha codificados em Base64.
| Campo | Descrição |
|---|
| Chave do Usuário | Nome da credencial do usuário (padrão: username) |
| Chave da Senha | Nome da credencial da senha (padrão: password) |
Authorization: Basic bWV1X3VzdWFyaW86bWluaGFfc2VuaGE=
Permite definir headers personalizados com suporte a interpolação de variáveis. Use esta opção quando a API exige um esquema de autenticação não padrão.
Clique em Adicionar Header para adicionar pares de Chave e Valor. Os valores suportam variáveis de credenciais com a sintaxe ${credentials.xxx}.
Exemplo:
| Chave | Valor |
|---|
X-Token | ${credentials.apiToken} |
X-Account-ID | ${credentials.accountId} |
Credenciais
A seção Credenciais (na aba Envio) permite armazenar pares chave-valor de forma segura. Clique em Adicionar Credencial para criar uma nova entrada com Nome da variável e Valor.
As credenciais podem ser referenciadas em qualquer campo da configuração usando a sintaxe ${credentials.nomeDaChave}.
Onde usar credenciais
| Local | Exemplo |
|---|
| Caminho da URL | /bot${credentials.botToken}/sendMessage |
| Template do Body | { "token": "${credentials.apiKey}" } |
| Parâmetros de Query | api_key=${credentials.apiKey} |
| Headers customizados | ${credentials.apiToken} |
Credenciais vs Autenticação
A autenticação e as credenciais resolvem problemas diferentes:
| Autenticação | Credenciais |
|---|
| O que faz | Adiciona headers automaticamente | Armazena variáveis reutilizáveis |
| Onde atua | Apenas em headers HTTP | Em qualquer campo (URL, body, query, headers) |
| Quando usar | Quando o serviço aceita autenticação via header | Quando o token precisa estar na URL, no body, ou em múltiplos locais |
/bot{TOKEN}/sendMessage), não em headers. Nesse caso, o tipo de autenticação é Nenhuma e o token é armazenado como credencial para ser usado no campo Caminho: /bot${credentials.botToken}/sendMessage.
Segurança
- Headers sensíveis (
authorization, x-api-key, token, secret) são mascarados automaticamente nos logs de atividade
- Utilize sempre HTTPS na URL Base para garantir que as credenciais trafeguem de forma segura
- Rotacione tokens e chaves periodicamente
