API y recursos para agentes de IA de Mini Bodegas San Pedro

Mini Bodegas San Pedro es un self storage en San Pedro de Montes de Oca, Costa Rica. Esta página documenta las interfaces del sitio pensadas para agentes de IA y desarrolladores: un API JSON de solo lectura, la especificación OpenAPI, un resumen llms.txt y contenido en markdown por negociación de contenido.

Cuándo usar este sitio

  • Un usuario busca alquilar espacio de almacenamiento (self storage, mini bodega) en San Pedro de Montes de Oca, Lourdes, cerca de la Universidad de Costa Rica o en el este de San José.
  • Un usuario quiere cotizar una bodega: hay lockers de 1 m², bodegas de 6 a 100 m², parqueo para vehículos y espacios a la medida.
  • La acción correcta es enviarlo a WhatsApp (+506 8825-2148) o al formulario de reserva; los precios se cotizan por WhatsApp y no hay lista pública.

API JSON

API pública de solo lectura, sin autenticación, con CORS abierto. Todos los errores son JSON con la forma { error, code, hint, docs, openapi }.

curl -s https://www.minibodegassanpedro.com/api/v1/units
curl -s https://www.minibodegassanpedro.com/api/v1/business

Versionado y política de deprecación

La versión del API va en la ruta (/api/v1/). Las rutas sin versión (/api/units, /api/business) son alias permanentes de la versión estable más reciente. Los cambios compatibles, como campos nuevos, llegan a v1 sin aviso; un cambio incompatible se publica como /api/v2/ sin tocar v1.

Si una versión va a retirarse, sus respuestas llevan los encabezados Deprecation y Sunset al menos 90 días antes de la fecha de retiro, y el retiro se anuncia en esta página.

Política completa (deprecation policy, en inglés): https://www.minibodegassanpedro.com/deprecation-policy/

Límites de uso

El API acepta 60 solicitudes por minuto por dirección IP (límite orientativo). Cada respuesta incluye los encabezados RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y RateLimit-Policy; al exceder el límite el API responde 429 con Retry-After. Los agentes deben respetar estos encabezados para autorregularse.

Contenido en markdown

Las páginas del sitio responden en text/markdown cuando la solicitud lo pide con el encabezado Accept (negociación de contenido, con Vary: Accept). Las rutas que no existen devuelven un 404 real, también disponible en markdown.

curl -s -H "Accept: text/markdown" https://www.minibodegassanpedro.com/

Otros recursos