Quando utilizar
Use interpolação quando precisar:- Inserir valores de parâmetros em URLs ou paths de API
- Adicionar datas dinâmicas às requisições (hoje, ontem, semana passada)
- Referenciar datas dos datapoints de extração
- Gerar nomes de arquivos com timestamps
- Construir query strings parametrizadas
Variáveis Simples
Substitua placeholders por valores dos parâmetros da sua integração. O nome da variável deve corresponder exatamente.Utilizando datapoint com variável simples
Para interpolar um valor de datapoint, adicione um query param com o nome do campo do datapoint. O nome do param fica disponível como variável.Interpolação DateTime
Insira datas atuais, calcule datas relativas e formate a saída para requisitos de APIs. A interpolação DateTime suporta três prefixos:Padrões de Formato
Use.format(pattern) para controlar a saída. Os padrões seguem os tokens de formato do dayjs.
Conversão de Timezone
Use.timezone(tz) para converter para um timezone específico antes de formatar. O timezone padrão é America/Sao_Paulo.
Aritmética de Datas
Adicione ou subtraia tempo usando.add(amount, unit) e .subtract(amount, unit).
Unidades disponíveis: days, weeks, months, years, hours, minutes, seconds
Usando Campos de Dados
Referencie datas dos seus datapoints de extração com a funçãodate(). Passe o caminho do campo como argumento.
Quando um parâmetro está ausente
Se um{{ parametro }} referenciado em uma URL, header ou body não tiver valor em tempo de execução, a requisição não é enviada: ela falha com um erro claro de interpolação informando o parâmetro ausente. Uma string vazia conta como ausente: enviá-la produziria uma requisição malformada (ex.: /items//details) que a API de destino rotearia incorretamente em vez de rejeitar.
Os nomes dos parâmetros diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao campo dos dados.