Programadores

Programadores

A API de integração serve para ligar ferramentas externas à tua organização sem dar acesso à base de dados. O modelo é pull: o cliente pede trabalho e devolve o resultado.

Autenticação

  • Token por organização (prefixo l4i_), mostrado uma única vez e guardado só como hash.
  • Permissões fechadas por token e validade de 1 a 365 dias; pode ser revogado a qualquer momento.
  • Cada pedido leva X-L4-Signature (HMAC-SHA256) e X-L4-Request-Id (idempotência por 10 minutos).
  • Tokens são criados por quem gere a organização, em Configurações › Integrações › API de integração.

Endpoints

  • POST/api/integrations/v1/deliveries/email/claim

    Reserva até 20 entregas de email de alertas pendentes da organização do token.

  • POST/api/integrations/v1/deliveries/email/complete

    Regista o resultado de uma entrega reservada (sent, failed ou unknown).

Limites e garantias

  • Corpo até 16 KB; respostas com Cache-Control: no-store.
  • Erros genéricos: token inválido, expirado ou revogado dão a mesma resposta (401).
  • Um resultado desconhecido nunca é reenviado; prefere-se perder um email a duplicá-lo.

Ainda não existe API pública de leitura de CRM ou financeiro. Não a anunciamos até existir.

Estado da plataformaVoltar ao site