Skip to content
ObraXRAY

Widget de risco embebido

Mostre o risco de qualquer empresa portuguesa diretamente no seu site. Drop-in, um script, zero dependências.

Início rápido#

Escolha o método de instalação adequado à sua stack — o snippet é igual, só muda o sítio onde o cola.

<div data-obx-nif="514566680" data-obx-key="obx_pk_..."></div>
<script src="https://embed.obraxray.com/v1/obx-embed.js" async></script>

Configuração#

  • data-obx-nifNIF da empresa portuguesa (9 dígitos)
  • data-obx-keyA sua chave pública obx_pk_… (visível no HTML, restrita por domínio)
  • data-obx-variantAparência do widget. Valores: summary (defeito), compact, detailed. Detalhes na secção abaixo.
  • data-obx-langIdioma das etiquetas: "pt" (predefinido) ou "en". Cai para o <html lang> mais próximo.

Variantes#

Três aparências disponíveis para se adaptarem ao espaço que tem na sua página. A SDK lê o atributo data-obx-variant e ajusta o tamanho inicial; uma mensagem postMessage acerta a altura final assim que o conteúdo carrega.

summary(defeito) · 100% × 80 px

Cartão em linha com pontuação, veredicto, nome da empresa e data da última atualização. Indicada para uma secção dedicada à empresa numa página de perfil.

Pré-visualização
<div data-obx-nif="514566680"
     data-obx-key="obx_pk_..."
     data-obx-variant="summary"></div>

compact180 × 180 px

Selo quadrado com ícone colorido e veredicto curto. Ideal para mostrar em linha junto ao nome da empresa numa lista ou tabela.

Pré-visualização
<div data-obx-nif="514566680"
     data-obx-key="obx_pk_..."
     data-obx-variant="compact"></div>

detailed100% × ~240 px

Painel completo com pontuação, veredicto e os pills das verificações preliminares (sem insolvências, sem PER, sem dívidas fiscais e à Seg. Social, alvará IMPIC, número de administradores). Use quando dedicar uma secção visível ao risco da empresa.

Pré-visualização
<div data-obx-nif="514566680"
     data-obx-key="obx_pk_..."
     data-obx-variant="detailed"></div>

Lista de domínios autorizados#

Cada chave está associada a uma lista de domínios. Pedidos de outros domínios são rejeitados em duas camadas: validação no servidor (Origin/Referer) e CSP frame-ancestors no browser. Para adicionar ou alterar domínios, contacte-nos.

Limites por chave#

120 renderizações em burst, recarregadas a 60/min por defeito. Limites mais altos disponíveis para parceiros — contacte-nos.

Privacidade#

Não armazenamos IPs nem user-agents dos visitantes do seu site. A telemetria de cada renderização contém apenas: timestamp, prefixo da chave, NIF consultado, domínio do parceiro, estado e latência.

Obter uma chave#

As chaves são emitidas manualmente para cada parceiro. Envie-nos uma mensagem para partners@obraxray.com