Riva dei Coz — API und Entwickler

Technische Hinweise zum Abruf von Unterkünften, Richtpreisen und Kontaktdaten. Die technische Dokumentation ist auf Englisch verfügbar.

OpenAPIEntwickler

When to use this

Compare accommodations, retrieve indicative EUR prices, plan arrival, and find the direct booking link. Public price queries return indicative rates and estimates, not confirmed availability or a binding offer. Use the booking page to confirm availability, final prices and conditions. Obtain the guest’s approval before booking.

Quickstart and authentication

Public price endpoints and MCP tools are free to query without registration, login or an API key.

curl 'https://www.rivadeicoz.com/api/v1/health'
curl 'https://www.rivadeicoz.com/api/v1/apartment-prices'
curl 'https://www.rivadeicoz.com/api/v1/seasonal-prices'

Endpoints and schemas

  • OpenAPI specification: public REST operations, inputs, success responses, and typed errors.
  • GET /api/v1/health: service status.
  • GET /api/v1/apartment-prices: indicative starting prices in EUR.
  • GET /api/v1/seasonal-prices: seasonal price windows.
  • POST /api/v1/pricing/quote: calculate an indicative stay estimate from dates and guest counts. This does not confirm availability or create a reservation.
  • MCP discovery: read-only site tools at /api/mcp.
  • Agent skills: stay planning instructions.

Errors

REST errors use application/problem+json (RFC 9457): type, title, status, detail, code, and hint. Existing error fields remain available. A 405 includes Allow. Unknown /api/ paths return JSON 404s. MCP retains its JSON-RPC error model.

Versioning and deprecation

Version 1 uses /api/v1/. The original /api/ paths are compatible aliases. Breaking changes require a new major URL version. Deprecation notices will be published at /developers before retirement. No version currently has a retirement date.

Rate limits

The contact form's existing limit is five requests per hour per IP, per server instance. Its responses include RateLimit-Policy and RateLimit using draft-ietf-httpapi-ratelimit-headers-11 syntax, and 429 includes Retry-After in seconds. These are advisory local quotas, not a distributed service guarantee. Public read endpoints do not currently impose a quota. Never automate the contact form or bypass its anti-spam checks.

Safe testing

GET /api/v1/health is a no-credentials smoke test. The documented public pricing operations are read-only and do not reserve or charge anything, but read production data. No reservation or payment is created by a price query. Use the curl examples above.