Endpoint

POST /api/externalAPIs/public/ingestXmlFeed

🔑 Autenticação

Inclua o token de domínio no cabeçalho da requisição:

Authorization: Bearer {SEU_DOMAIN_TOKEN}

🌐 Base URL

Utilize {BASE_URL} para apontar ao ambiente adequado (por exemplo, produção em https://api.tolky.to).


Corpo da Requisição

CampoTipoObrigatórioDescrição
urlstringsimURL pública do XML a ser ingerido
itemTagstringnãoNome da tag de item no XML (ex.: imovel). Se omitido, o serviço tenta inferir

Comportamento

  • Realiza download e processamento via streaming do XML informado.
  • Mapeia campos conhecidos para colunas da tabela properties.
  • Atribui campos não mapeados ao JSONB external_extra.
  • Executa upsert por identificadores conhecidos do feed.

Exemplo de Requisição

  • Tab Title

  • Tab Title

curl --location '{BASE_URL}/api/externalAPIs/public/ingestXmlFeed' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {SEU_DOMAIN_TOKEN}' \
  --data-raw '{
    "url": "https://universal-ftp2.s3.us-west-2.amazonaws.com/123i/valore-123i-6060-ambos.xml",
    "itemTag": "imovel"
  }'

Códigos de Resposta

  • 200: Ingestão concluída
  • 400: Requisição inválida (ex.: url ausente ou inválida)
  • 401: Não autorizado
  • 500: Erro interno do servidor

Observações

  • É possível sobrescrever por requisição variáveis de ambiente usadas internamente (FEED_123I_URL, FEED_123I_ITEM_TAG), com base nos campos enviados.
  • Para feeds com estrutura distinta, defina itemTag para garantir a leitura correta de cada item.