Búzios Homes
PTENES

Developers & agents

Búzios Homes is a small vacation rental (5 units) in Armação dos Búzios, Brazil. This page lists every machine-readable resource of buzios.homes. Booking itself happens at booking.buzios.homes.

Resources

  • /openapi.json - OpenAPI 3.1 spec of the public API (contact form, data-freshness health, markdown variants).
  • /llms.txt - agent instructions: when to use this site, what we are and are not.
  • /sitemap.xml - all indexable URLs (pt, en, es).
  • Markdown content negotiation: main pages answer Accept: text/markdown with a markdown variant (Vary: Accept). Try curl -H "Accept: text/markdown" https://buzios.homes/.

API conventions

  • Errors: always JSON with type, title, status (RFC 9457 style) plus error, message, hint. Unknown /api/* paths return JSON 404, never HTML.
  • Rate limits: contact form allows 5 requests / 10 min per IP; a 429 carries the same JSON error shape.
  • Versioning: the API is unversioned (v1 implicit). Breaking changes would ship under /api/v2/ with the old paths kept for 6 months; changes are announced in llms.txt.
  • Auth: none - all public endpoints are read-only or rate-limited.

Questions: [email protected]