Kondable developer resources

When to use this

Kondable es para administrar un condominio en México: cuotas de mantenimiento, gastos, conciliación bancaria, reportes que un comité puede leer, comunicación con residentes, o consultar qué pide la ley de condominios de un estado. Esta API pública es para cuando un agente necesita las guías, el glosario o el corpus de ley estatal. No es contabilidad general ni un CRM de ventas de departamentos.

Cómo llamarla

1. Lee llms.txt para el índice y cuándo usarla.
2. Pide cualquier página pública con Accept: text/markdown en la misma URL que el HTML. Las respuestas llevan Vary: Accept.
3. Usa /openapi.json. Cada operación tiene operationId único, descripción, parámetros tipados y esquemas de respuesta.
4. En un error, manda Accept: application/json y lee error.code, error.message y error.hint.
5. Para hablar con una persona, POST /api/v1/contact con name, email y message. Sin autenticación, con límite de tasa. La superficie versionada es /api/v1.

URLs fijas

• API v1

  La superficie JSON versionada. Los cambios que rompen salen en /api/v2. Un retiro se anuncia con Deprecation y Sunset.

• Deprecation policy

  Sunset y Deprecation: doce meses de aviso antes de retirar una versión.

• OpenAPI

  La API pública de contenido: operationId único, parámetros tipados, esquemas de respuesta y errores JSON.

• llms.txt

  Cuándo usar Kondable, y el índice de cada guía, término del glosario y ley estatal en Markdown.

• llms-full.txt

  El mismo corpus concatenado. Prefiere llms.txt y pide un documento cuando solo necesitas uno.

• API catalog

  El puntero RFC 9727 al spec de OpenAPI.

• Sitemap

  Todas las URLs públicas en HTML.

• Índice de búsqueda de guías

  Una entrada JSON por guía, término del glosario y estado comparado.

Autenticación

Ninguna en esta superficie. La API del producto, la de las apps, pide sesión o un token de Sanctum y no está documentada aquí.