Desenvolvedor
Ingestão de Feed XML de Imóveis
Baixa e processa um feed XML (ex.: 123i) via streaming, realizando upsert em properties.
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
Campo | Tipo | Obrigatório | Descrição |
---|---|---|---|
url | string | sim | URL pública do XML a ser ingerido |
itemTag | string | não | Nome 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ída400
: Requisição inválida (ex.:url
ausente ou inválida)401
: Não autorizado500
: 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.