O tutorial oficial de 18 de janeiro de 2023 mostrou como encapsular uma chamada ao Geocodify em um app personalizado do Make. Isso evita repetir a configuração HTTP em cada cenário. Ter uma API, porém, não garante compatibilidade automática: autenticação, formato de resposta e permissões precisam ser conferidos.
A captura do artigo preserva a explicação, mas não todos os blocos de código exibidos na página. Esta adaptação não apresenta código ausente como se tivesse sido recuperado. O exemplo de Base abaixo foi reconstruído a partir da documentação oficial indicada.
Condições para preparar o exemplo
Nos pré-requisitos, o original mencionava uma conta gratuita do Geocodify. Essa condição não é confirmada aqui; confira os termos atuais diretamente com o fornecedor.
1. Entenda a chamada
A documentação do Geocodify descreve a base https://api.geocodify.com/v2, o endpoint /geocode e os parâmetros api_key e q. O segundo contém o endereço pesquisado.
Se testar a chamada em um cliente HTTP, use uma credencial sua e um endereço de teste. Não publique URLs com chaves reais em logs, screenshots ou exemplos compartilhados.
2. Configure o app e a conexão
No tutorial, o app era criado em My Apps, com nome, descrição, idioma e identidade visual. Verifique a interface e os requisitos atuais antes de enviar o ícone.
Crie uma conexão de chave de API. Seu parâmetro deve pedir a chave do usuário; no exemplo, o nome interno é apiKey. Consulte a referência de conexões para estruturar os parâmetros e a comunicação.
Na comunicação da conexão, uma chamada de teste deve usar a chave fornecida. O artigo acessava esse parâmetro por {{parameters.apiKey}}. Um formulário que aceita a chave sem fazer uma chamada não comprova que ela é válida.
3. Defina a Base
A documentação oficial da Base explica a herança de URL, parâmetros e configuração de logs. Este fragmento ilustra a base e a autenticação para o exemplo; não é um app completo:
{
"baseUrl": "https://api.geocodify.com/v2",
"qs": {
"api_key": "{{connection.apiKey}}"
},
"log": {
"sanitize": ["request.qs.api_key"]
}
}
Nos módulos, connection.apiKey referencia os dados da conexão, enquanto parameters representa os parâmetros do próprio módulo. Não troque esses contextos.
A sanitização configura a ocultação do campo indicado nos logs do Make. Não é uma garantia de que a chave jamais apareça em qualquer sistema, resposta de erro ou ferramenta externa. Verifique os logs com cuidado também na chamada de teste da conexão.
4. Crie o módulo de busca
O artigo escolhia um módulo do tipo Search, associado à conexão, com um parâmetro de endereço. A comunicação chamava /geocode e enviava o endereço em q.
Use a referência oficial de módulos Search para definir a saída. Um módulo de busca pode precisar iterar a lista recebida para devolver um bundle por resultado. Confira a estrutura JSON real do Geocodify antes de configurar iterate, output e os campos de interface; não adivinhe o caminho da lista.
5. Teste antes de compartilhar
Verifique endereço válido, nenhuma correspondência e chave inválida. Confira o conteúdo retornado e a ausência de credenciais visíveis nos logs pertinentes. Esta página não relata uma chamada autenticada executada por nós.
Publicar ou compartilhar um app é uma decisão separada de testá-lo. Não use as instruções históricas de publicação como autorização para disponibilizar a integração a outras organizações. O convite do exemplo original foi mantido como referência, sem garantia de disponibilidade.
Nota editorial: as recomendações de revisão e teste são acréscimos desta adaptação; não relatam uma execução real dos cenários.