# Verificação de URL



<ToolHero tool="verificacao-de-url" />

## Visão geral

Use antes de exibir links gerados por usuários ou de redirecionar alguém para um destino externo. É a mesma verificação que o [QR Dinâmico](/ferramentas/qr-dinamico) aplica às URLs de destino.

<EndpointList tool="verificacao-de-url" />

## Custos

As duas operações são leituras medidas: entram na [franquia diária](/cobranca-e-limites#franquia-diaria) e, depois dela, debitam o valor indicado em cada endpoint.

## Endpoints

### Verificar URL

<Endpoint id="safety.check" example={{ query: { url: 'https://example.com' } }}>
  Query: `url` (obrigatório, URL absoluta). Resultados são mantidos em cache por 1 hora.

  <Callout type="warn" title="Resposta fora do envelope padrão">
    Esta rota responde `{ "is_safe": … }` diretamente, sem `success`/`data`. Se o serviço de verificação estiver indisponível, a resposta é `is_safe: true` (*fail-open*), para não bloquear o seu fluxo. Em dry-run a resposta volta ao envelope padrão.
  </Callout>
</Endpoint>

### Favicon de um domínio

<Endpoint id="safety.favicon" example={{ query: { domain: 'example.com' }, response: 'binary' }}>
  Query: `domain` (obrigatório).
</Endpoint>

## Erros

<ErrorTable tool="verificacao-de-url" />