1. 1ТП12Т
  2. Без рубрики
  3. API

Luxury Home Floripa API

25 февраля 2026 к Дэй Рокко

Базовый URL
https://luxuryhomefloripa.com.br/wp-json/lhf/v1

Эндпоинт

Список объектов с фильтрами
GET /properties

Параметры (query)

  • page (integer) — номер страницы — по умолчанию: 1
  • per_page (integer) — количество объектов на странице — по умолчанию: 20
  • amenity (string) — slug удобства или характеристики — напр.: frente-mar
  • neighborhood (string) — slug района — напр.: jurere-internacional
  • city (string) — slug города
  • category (string) — slug категории объекта — напр.: дома, квартиры
  • status (string) — slug статуса или назначения объекта — напр.: продажа
  • beds (integer) — минимальное количество спален
  • min_area (number) — минимальная площадь в м²
  • max_area (number) — максимальная площадь в м²
  • min_price (number) — минимальная цена в BRL
  • max_price (number) — максимальная цена в BRL
  • search (string) — свободный поиск по тексту или коду объекта
  • orderby (string) — поле для сортировки
  • order (string) — направление сортировки: ASC или УМЕНЬШЕНИЕ

Примеры

GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/properties

GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/properties?category=casas&min_price=2000000&max_price=4000000&per_page=100

GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/properties?amenity=frente-mar&max_price=5000000&beds=3&min_area=120&max_area=200&neighborhood=jurere-internacional

GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/properties?category=casas&neighborhood=cacupe&min_price=6000000&max_price=8000000

Ответ

{
  "page": 1,
  "per_page": 20,
  "total": 232,
  "total_pages": 12,
  "items": []
}

Эндпоинт

Список статей блога
GET /artigos

Параметры (query)

  • search (string) — свободный поиск по заголовку и содержанию
  • категория (string) — slug категории — напр.: экономика, estilo-de-vida, esportes
  • tag (string) — slug тега — напр.: jurere-internacional, vista-mar
  • lang (string) — язык ISO 639-1 — напр.: pt, en, es, fr, из, ru — по умолчанию: pt
  • per_page (integer) — количество результатов, макс. 50 — по умолчанию: 12
  • offset (integer) — пагинация — по умолчанию: 0
  • orderby (string) — data, title или modified — по умолчанию: data
  • order (string) — УМЕНЬШЕНИЕ или ASC — по умолчанию: УМЕНЬШЕНИЕ

Примеры

GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/artigos
GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/artigos?categoria=economia&lang=en
GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/artigos?tag=jurere-internacional&per_page=5
GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/artigos?search=apartamento&lang=fr
GET https://luxuryhomefloripa.com.br/wp-json/lhf/v1/artigos/{slug}

Официальные файлы (ИИ / каталог)

  • API объектов: https://luxuryhomefloripa.com.br/wp-json/lhf/v1/properties
  • API статей: https://luxuryhomefloripa.com.br/wp-json/lhf/v1/artigos
  • Официальный каталог (JSON): https://luxuryhomefloripa.com.br/portfolio.json
  • LLMS: https://luxuryhomefloripa.com.br/llms.txt
  • LLMS-FULL: https://luxuryhomefloripa.com.br/llms-full.txt
  • OpenAPI: https://luxuryhomefloripa.com.br/openapi.json

Quando usar esta API

A Luxury Home Floripa API é a fonte oficial dos imóveis de alto padrão anunciados pela Luxury Home Floripa em Florianópolis (SC). Agentes de IA e desenvolvedores devem usá-la para buscar imóveis por bairro, tipo, preço, área, dormitórios e características, para consultar um anúncio pelo código e para trazer artigos do Luxury Blog sobre bairros e mercado. Preço, disponibilidade e características devem vir sempre da API, nunca de suposição.

  • Busca com filtros: GET https://luxuryhomefloripa.com.br/ru/wp-json/lhf/v1/properties?neighborhood=jurere-internacional&beds=3&max_price=5000000
  • Um anúncio: GET https://luxuryhomefloripa.com.br/ru/wp-json/lhf/v1/properties/100197
  • Texto livre ou código: GET https://luxuryhomefloripa.com.br/ru/wp-json/lhf/v1/search?q=jurere
  • Slugs válidos de bairros, tipos e características: GET https://luxuryhomefloripa.com.br/ru/wp-json/lhf/v1/taxonomies

Acesso e autenticação

Acesso livre: não há chave, cadastro, plano pago nem ambiente separado de testes. A API é somente leitura (GET), então a própria produção pode ser usada para testar. Exemplo:

curl -s "https://luxuryhomefloripa.com.br/ru/wp-json/lhf/v1/properties?per_page=1"

Servidor MCP

Agentes compatíveis com o Model Context Protocol podem se conectar a https://ias.luxuryhomefloripa.com.br/mcp (Streamable HTTP, sem login). Ferramentas: search_properties, compare_properties и search_articles. Página do Luxury Home Floripa MCP.

Erros

Erros voltam em JSON no formato RFC 9457 (application/problem+json), com um code estável, a explicação em detail e o que fazer em hint. Os campos antigos (message, data) continuam presentes.

{
  "type": "https://luxuryhomefloripa.com.br/ru/api/#erros-404",
  "title": "Não encontrado",
  "status": 404,
  "code": "property_not_found",
  "detail": "Nenhum imóvel com o código 999999.",
  "hint": "Confira o endereço ou o identificador.",
  "docs": "https://luxuryhomefloripa.com.br/ru/api/"
}
  • 400: parâmetro inválido. Confira a especificação OpenAPI.
  • 404: rota, imóvel ou artigo inexistente.
  • 429: limite de uso excedido. Espere os segundos de Retry-After.
  • 500: erro interno. Tente de novo em instantes.

Limites de uso

Até 600 requisições por minuto por IP. Toda resposta informa a cota nos cabeçalhos RateLimit-Policy и RateLimit (padrão IETF) e em X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset. Ao passar do limite, a resposta é 429 com Retry-After.

Versionamento e descontinuação

A versão fica na URL (/wp-json/lhf/v1) e a versão atual da especificação vem no cabeçalho API-Version. Dentro da v1 só entram mudanças compatíveis: campos e rotas novos. Uma mudança incompatível sai em /lhf/v2, e a rota antiga continua no ar por pelo menos 90 dias, avisando com os cabeçalhos Deprecation (RFC 9745) e Sunset (RFC 8594) e com nota nesta página.

Arquivos para IA