# Guia de conexão

A integração dos anúncios ocorre em uma arquitetura baseada em polling (opens new window), ou seja, de tempos em tempos uma sonda do Grupo ZAP baixa o arquivo XML e começa o processo de integração dos anúncios.

Esta sonda faz a busca do arquivo XML a cada 8 horas, totalizando 3 vezes ao dia.

# User-Agent

Para baixar o arquivo XML, uma requisição http(s) é realizada e no header desta requisição é definido o User-Agent (opens new window):

User-Agent: VivaRealBot/1.0 (+http://www.vivareal.com/bot.html)

Para que não ocorram erros no download (ex: HTTP 403), é necessário que este User-Agent esteja liberado no seu servidor ou pela sua hospedagem.

# Tempo Limite (Timeout)

  • A sonda efetua uma requisição http(s) para efetuar o download do arquivo XML, nesta conexão alguns timeouts são definidos para garantir a resiliência de ambos os lados (cliente/servidor).

# Tempo limite para estabelecer a conexão http(s)

  • 60 segundos

# Tempo limite para realizar o download do Arquivo XML (bytes)

  • 20 minutos

# TLS

Atualmente são suportadas as seguintes versões de TLS (opens new window) (Transport Layer Security) para estabelecer a conexão:

  • TLSv1
  • TLSv1.1
  • TLSv1.2

# IPs do Grupo ZAP

Caso você possua algum firewall, é necessário adicionar os nossos IPs (opens new window) (Internet Protocol) de saída para que possamos acessar o seu arquivo XML (bytes):

  • 18.231.52.186
  • 35.175.17.150
  • 100.24.160.21
  • 54.156.129.60
  • 3.208.42.223
  • 35.173.9.239
  • 3.89.171.165

# Certificados

Se você utiliza HTTPS (opens new window) (Hypertext Transfer Protocol Secure), nós não aceitamos certificados auto assinado (opens new window).

# Redirect de url

Não suportamos redirect de HTTP para HTTPS e nem nenhum outro tipo de redirect.

# Tamanho máximo de caracteres na URL

Atualmente suportamos URL com tamanho máximo de 255 caracteres.