Luméa
InicioPropiedadesEncuentra tu Propiedad IdealMi PerfilPortal Luméa
Asesoría Patrimonial+52 442 599 4275
Luméa Capital Real Estate — Developer Portal & API v1

Documentación Técnica,
APIs REST v1 y Protocolos para Agentes.

Bienvenido al portal técnico de Luméa Capital Real Estate. Aquí encontrarás especificaciones OpenAPI 3.1, guías de negociación de Markdown para agentes de IA, ejemplos de línea de comandos (CLI / cURL) y endpoints v1 estructurados para integración con CRM y plataformas proptech.

EspecificaciónOpenAPI 3.1 JSON
Estándar LLMllms.txt (Instrucciones)
Base Completallms-full.txt
Indexaciónsitemap.xml

Política de Versionamiento y Deprecación

La API de Luméa Capital sigue una estrategia de versionamiento explícito en la ruta URL (/api/v1/).

Estabilidad y GarantíaLos endpoints bajo /api/v1/ son inmutables en su contrato de datos. No se eliminan campos existentes en versiones menores.
Aviso de DeprecaciónCualquier cambio mayor o retiro de endpoints incluirá los encabezados HTTP estándar Deprecation y Sunset con un mínimo de 6 meses de anticipación.

1. Negociación de Contenido Markdown (acceptmarkdown.com)

Luméa Capital implementa el estándar abierto acceptmarkdown.com. Cualquier agente de IA o scraper puede solicitar el encabezado Accept: text/markdown en cualquier ruta de nuestro portal (incluyendo la página principal, nosotros, contacto, privacidad y fichas de propiedades) para recibir respuestas en formato Markdown limpio, sin carga innecesaria de scripts o HTML visual.

// Ejemplo de petición en cURL
curl -sS -L -i -H 'Accept: text/markdown' https://lumeacapital.mx/
HTTP/2 200 OK
Content-Type: text/markdown; charset=utf-8
Vary: Accept

# Luméa Capital — Activos Inmobiliarios de Lujo en San Luis Potosí...

2. Endpoints REST v1 & Interacción cURL / CLI

POST/api/v1/contact
Lead & Prospect Intake

Registra prospectos calificados, solicitudes de cotización o solicitudes de recorrido privado para propiedades individuales o asesoría general.

Comando cURL CLI:
curl -s -X POST https://lumeacapital.mx/api/v1/contact \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Lic. Fernando Ortiz",
    "phone": "+524441234567",
    "email": "fernando@empresa.com",
    "message": "Solicito información de departamentos en Torre Utente",
    "propertyId": "torre-utente",
    "origin": "curl_agent"
  }'
Respuesta Exitosa (200 OK):
{
  "success": true,
  "refCode": "LU-A94F1",
  "leadId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "normalizedPhone": "4441234567"
}
POST/api/v1/partner-waitlist
Partner Inmobiliaria Intake

Inscribe agencias inmobiliarias y brokers independientes al programa Partner Fundador.

Comando cURL CLI:
curl -s -X POST https://lumeacapital.mx/api/v1/partner-waitlist \
  -H "Content-Type: application/json" \
  -d '{
    "agencyName": "Inmobiliaria Potosina Premier",
    "contactName": "Ing. Sofía Morales",
    "email": "sofia@inmobiliariapotosina.mx",
    "phone": "+524449876543",
    "city": "San Luis Potosí",
    "primaryInterest": "inventory,team",
    "referredByCode": "LP-S3YAH"
  }'

3. Rate Limiting & Respuestas de Error JSON

Para garantizar que agentes autónomos puedan auto-regularse en tiempo real, todas las respuestas de API devuelven encabezados estándar IETF RateLimit:

  • RateLimit-Limit: 300 (Peticiones permitidas en la ventana)
  • RateLimit-Remaining: 299 (Peticiones restantes)
  • RateLimit-Reset: 60 (Segundos hasta renovación de ventana)
  • Retry-After: 60 (Tiempo de espera obligatorio en caso de 429)
// Formato Estructurado de Error JSON (4xx / 5xx)
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Límite de peticiones excedido (máximo 300 por minuto). Por favor, intenta de nuevo en un minuto.",
    "hint": "Consulte https://lumeacapital.mx/developers para información sobre cuotas y uso de API."
  }
}
Volver a InicioContacto Soporte Técnico