Ambiente
As variáveis de ambiente armazenam valores reutilizáveis que você pode referenciar em requisições de Reenvio, Automação e Fluxos de trabalho.
Criar e editar variáveis
- Abra Ambiente na navegação à esquerda.
- Clique em Adicionar variável.
- Insira um nome que comece com uma letra ou sublinhado, seguido de letras, números, sublinhados ou hífens (máximo de 64 caracteres).
- Insira o valor.
- Ative Secreta se o valor for sensível (chaves de API, tokens, senhas). Os valores secretos são mascarados na interface e excluídos do contexto de IA.
- Clique em Salvar.
Para editar uma variável existente, clique em sua linha e atualize o nome ou o valor.
Usar variáveis em requisições
Referencie uma variável de ambiente usando o prefixo env.:
{{env.VARIABLE_NAME}}Exemplos:
- Campo Host:
{{env.TARGET_HOST}}(armazene um nome de host, não uma URL completa). - Cabeçalho de autorização:
Bearer {{env.AUTH_TOKEN}}. - Corpo da requisição:
{"tenant": "{{env.TENANT_ID}}"}; ative a interpolação de variáveis no modelo do corpo no Reenvio quando quiser substituições dentro do corpo.
O Ogma resolve marcadores de ambiente válidos no momento do envio. Uma variável ausente produz um erro em vez de enviar silenciosamente um valor não resolvido. Os envios de Reenvio nos modos Bruto e Hex preservam os bytes exatos e não expandem marcadores.
Escopo das variáveis
Escolha Global para valores compartilhados pelos projetos deste espaço de trabalho do Ogma, ou Projeto para valores do projeto ativo. Os valores de projeto substituem os globais com o mesmo nome. Reenvio também aceita substituições por coleção e sessão; a prioridade é sessão, coleção, projeto e, por fim, global.
Transformações e valores dinâmicos
Acrescente transformações com uma barra vertical, por exemplo {{env.AUTH_TOKEN|base64_encode}} ou {{env.SEARCH|url_encode}}. A cadeia é aplicada da esquerda para a direita. Verifique a saída com uma requisição de teste: nomes de transformação não reconhecidos são ignorados, não relatados como erros.
Os valores integrados não precisam de uma variável salva:
| Marcador | Valor |
|---|---|
{{$timestamp}} | Horário Unix atual em milissegundos. |
{{$timestamp_s}} | Horário Unix atual em segundos. |
{{$uuid}} | Um novo UUID. |
{{$random(16)}} | 16 bytes aleatórios representados em hexadecimal. |
{{$date(%Y-%m-%d)}} | Data UTC atual usando um padrão de formato de data. |
Os valores armazenados não são expandidos recursivamente. Se um valor contiver outro marcador, esse texto aninhado permanece literal.
Acesso do assistente de IA
O assistente de IA pode ler nomes e valores de variáveis não secretas para fornecer contexto quando você pede uma análise de requisição ou um rascunho de plano de testes. Variáveis secretas nunca são incluídas no contexto de IA.
Usos comuns
| Variável | Valor de exemplo |
|---|---|
BASE_URL | https://api.example.com |
AUTH_TOKEN | eyJhbGci... (marque como secreta) |
TARGET_HOST | app.example.com |
API_KEY | sk-... (marque como secreta) |
USER_ID | 12345 |