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.:urlausente 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
itemTagpara garantir a leitura correta de cada item.