O Acesso à API ajuda a sua equipa a gerar e gerir a chave utilizada pelos fluxos de trabalho e integrações da ferramenta API para Perfis do Google Business do Localith.
Visão geral
Utilize esta página quando precisar de criar uma chave API para o Localith, ligar uma integração como o n8n, ou compreender como as credenciais API se enquadram nas suas operações mais amplas do Google Business Profile.
Este guia foca-se no acesso à API ao nível da conta e na gestão de chaves. Não pretende documentar cada endpoint ou padrão de integração possível. Para ideias de implementação, combine esta página com as Instruções de Configuração do n8n.
Antes de começar
Antes de criar ou regenerar uma chave API, certifique-se de que:
- tem acesso à conta Localith que é proprietária dos perfis ligados
- está autorizado a gerir credenciais API nesse espaço de trabalho
- sabe qual integração ou fluxo de trabalho irá utilizar a chave
- tem um local seguro para guardar a chave após a sua geração
Se a sua equipa utiliza automatizações, decida também se a chave deve ser reutilizada em vários fluxos de trabalho ou reservada para uma integração específica.
Abrir a chave API
A sua chave API está acessível a partir do submenu Conta na parte inferior da barra lateral do Localith.
- Clique no menu Conta na parte inferior da barra lateral.
- Selecione Chave API no submenu.
- Aparece uma janela com a sua chave API atual e uma ligação para a documentação da API.
Copiar ou regenerar a sua chave API
Utilize este fluxo quando precisar de credenciais para uma nova integração ou fluxo de trabalho.
- Abra Conta > Chave API no Localith.
- Copie a chave existente, ou regenere-a se precisar de uma nova.
- Cole a chave na integração de destino, como o n8n ou uma ferramenta interna.
- Guarde as credenciais da integração e teste o acesso com um pedido apenas de leitura primeiro.
Se utiliza o nó comunitário do Localith para n8n, siga o próximo passo de configuração nas Instruções de Configuração do n8n.
Como o Acesso à API se enquadra no fluxo de trabalho
A chave API é a camada de credenciais da conta por trás das integrações do Localith. Na prática, isso significa que é utilizada para:
- autenticar fluxos de trabalho de automatização
- ligar o Localith a ferramentas como o n8n
- permitir acesso controlado a avaliações, fichas e dados de métricas
- suportar fluxos de trabalho de atualização onde a integração escreve alterações de volta nas operações geridas pelo Localith
Os exemplos confirmados atualmente incluem fluxos de trabalho de avaliações, fichas e métricas descritos no guia de configuração do n8n.
Segurança e orientação operacional
- Trate a chave API como uma credencial sensível.
- Teste os novos fluxos de trabalho com ações apenas de leitura ou de âmbito limitado antes de automatizar operações de escrita.
- Se uma chave for exposta ou partilhada de forma incorreta, regenere-a e atualize as integrações afetadas.
- Mantenha a responsabilidade interna clara para que a sua equipa saiba quem é responsável pelas credenciais de integração.
Limites ou casos especiais
- A cobertura de fontes atuais confirma o ecrã de Acesso à API e o fluxo de gestão de chaves, mas ainda não fornece uma referência completa de programador endpoint por endpoint.
- As integrações podem necessitar da sua própria validação, aprovações ou lógica de ramificação fora do Localith.
- A utilização da API deve seguir as permissões da sua conta e qualquer comportamento de limite de taxa aplicável.
Perguntas frequentes
P: Onde encontro a minha chave API?Clique em Conta > Chave API na parte inferior da barra lateral do Localith. Uma janela mostrará a sua chave com um botão de copiar.
P: Posso usar a mesma chave em vários fluxos de trabalho?Sim. A orientação de suporte atual indica que a mesma chave pode ser reutilizada em vários fluxos de trabalho quando isso se adequar à sua configuração operacional.
P: O que devo fazer se pensar que uma chave foi exposta?Regenere a chave e, em seguida, atualize cada integração que estava a utilizar a anterior.