Pular para o conteúdo principal

Integre um processo de locais, não apenas um endpoint

As integrações Alkax mais sólidas preservam um ID de local estável, mantêm os dados privados do processo separados dos dados públicos do local e escolhem o nível de confiança adequado à decisão.

Padrões comuns​

Resolver um local​

Utilize a pesquisa Alkax quando um utilizador ou operador precisar de selecionar um local existente por nome, localidade, Plus Code, coordenadas, categoria ou proximidade.

Guarde: o ID do local Alkax e os campos necessários para apresentação.
Volte a verificar: os dados de apresentação mutáveis quando precisarem de estar atuais.

Registar um destino em falta​

Permita que um utilizador autorizado crie um local quando a pesquisa não encontrar uma correspondência adequada. Apresente os avisos de duplicados em vez de forçar automaticamente a criação.

Guarde: o ID de local devolvido.
Evite: tratar cada endereço de entrega em texto livre como um novo local público.

Verificar ou enriquecer​

Utilize o endpoint de parceiro relevante quando uma decisão operacional precisar de um sinal mais forte de qualidade de endereço ou verificação.

Guarde: o resultado, a sua data e hora e qualquer identificador de política ou versão.
Evite: interpretar um sinal de confiança da plataforma como prova de propriedade de terreno ou de estatuto legal.

Confirmar antes da expedição​

Utilize Delivery Intelligence quando o destinatário tiver de aprovar ou corrigir o destino proposto antes da preparação da encomenda.

Guarde: o ID do pedido, a referência do comerciante, o instantâneo confirmado imutável, o estado do ciclo de vida e o ID do evento.
Proteja: o contacto do destinatário, a ligação de confirmação, as instruções privadas, os conteúdos da entrada, a credencial do comerciante e o segredo de assinatura.

Abrir o guia Delivery Intelligence →

Your frontend → Your backend → Alkax API
                         ↘ Your webhook receiver

O navegador comunica com o seu backend. O backend guarda uma credencial de projeto específica do ambiente, chama a Alkax, aplica as regras do tenant e devolve apenas os dados de que o navegador precisa.

Lista de verificação para integração em Produção​

  • Utilize credenciais de projeto separadas para Sandbox e Produção.
  • Guarde as credenciais e os segredos de webhooks num gestor de segredos.
  • Defina tempos limite e um número limitado de novas tentativas.
  • Utilize chaves de idempotência onde o processo as exigir.
  • Guarde os IDs Alkax em vez de tentar fazer correspondências pelo título mais tarde.
  • Elimine eventos webhook duplicados antes de aplicar efeitos.
  • Oculte dados pessoais e ligações seguras nos registos.
  • Monitorize a quota, 429, falhas de autenticação e a acumulação de webhooks.
  • Teste os casos de falha: duplicados, correções, expiração, revogação e novas tentativas.

Utilize a referência da API para os esquemas exatos depois de escolher o padrão.