Cambios de contrato

Este documento versiona el contrato público de https://api.rateshooter.com. La versión actual es 2.0. La ruta sigue siendo /v1 — solo la versión del documento cambió; no es una ruta nueva.

2.0 — 2026-10-03

Cambio mayor, con renombres que rompen compatibilidad (no son alias, son reemplazos):

• Todo el contrato pasó a snake_case. Cualquier nombre en camelCase que hayas visto antes ya no existe.
• hotel_id reemplaza al parámetro que antes identificaba un hotel por su id interno de catálogo — sin alias. Si tu integración todavía envía el nombre anterior, recibirás un 400 que nombra explícitamente hotel_id; el valor es el mismo entero, solo cambia la clave.
• En POST /v1/quotes, hotels identifica cada hotel del lote: antes cada elemento era un objeto con una sola clave; ahora puede ser el entero directamente o un objeto con hotel_id, hotel_ref o name — ver cotización múltiple.
• stay vive en la raíz de la respuesta, no repetido dentro de cada resultado del lote.
• En el 422 por habitaciones, las claves del cuerpo pasaron a snake_case: min_rooms y max_rooms reemplazan a sus nombres anteriores — ver errores y límites.

{
  "status": "ok",
  "hotel": {
    "resolved_name": "Grand Oasis Cancun",
    "hotel_id": 2008,
    "verified": true
  },
  "offers": [
    {
      "vendor": "The Grand Oasis Cancun - All Inclusive",
      "price_per_night": 245.40494,
      "total_price": 245.40494,
      "taxes_included": true
    },
    {
      "vendor": "Super.com",
      "price_per_night": 185.50781,
      "total_price": 185.50781,
      "taxes_included": true
    },
    {
      "vendor": "trivago DEALS",
      "price_per_night": 189.47403,
      "total_price": 189.47403,
      "taxes_included": true
    },
    {
      "vendor": "Traveluro",
      "price_per_night": 187.65692,
      "total_price": 187.65692,
      "taxes_included": true
    },
    {
      "vendor": "Billabook.com",
      "price_per_night": 210,
      "total_price": 210,
      "taxes_included": true
    },
    {
      "vendor": "goseek.com",
      "price_per_night": 219.50781,
      "total_price": 219.50781,
      "taxes_included": true
    },
    {
      "vendor": "Despegar",
      "price_per_night": 301.375,
      "total_price": 301.375,
      "taxes_included": true
    },
    {
      "vendor": "Expedia.mx",
      "price_per_night": 302.93268,
      "total_price": 302.93268,
      "taxes_included": true
    },
    {
      "vendor": "Agoda",
      "price_per_night": 230.1875,
      "total_price": 230.1875,
      "taxes_included": true
    },
    {
      "vendor": "Booking.com",
      "price_per_night": 297.90625,
      "total_price": 297.90625,
      "taxes_included": true
    },
    {
      "vendor": "Priceline",
      "price_per_night": 305.90625,
      "total_price": 305.90625,
      "taxes_included": true
    },
    {
      "vendor": "Evendo",
      "price_per_night": 256.15396,
      "total_price": 256.15396,
      "taxes_included": true
    },
    {
      "vendor": "Central de Reservas",
      "price_per_night": 247.38129,
      "total_price": 247.38129,
      "taxes_included": true
    },
    {
      "vendor": "Hotel prive",
      "price_per_night": 292.5,
      "total_price": 292.5,
      "taxes_included": true
    },
    {
      "vendor": "Hoteles.com",
      "price_per_night": 302.93268,
      "total_price": 302.93268,
      "taxes_included": true
    },
    {
      "vendor": "Qantas Hotels",
      "price_per_night": 302.1284,
      "total_price": 302.1284,
      "taxes_included": true
    },
    {
      "vendor": "klook",
      "price_per_night": 235.61737,
      "total_price": 235.61737,
      "taxes_included": true
    },
    {
      "vendor": "Clicktrip.com",
      "price_per_night": 241.47806,
      "total_price": 241.47806,
      "taxes_included": true
    }
  ],
  "meta": {
    "offers_count": 18,
    "billable": true
  },
  "stay": {
    "checkin": "2026-12-10",
    "checkout": "2026-12-11",
    "nights": 1,
    "adults": 2,
    "rooms": 1,
    "children": [],
    "currency": "USD"
  }
}

Todo nombre de este sitio (parámetros, propiedades, headers) se verifica contra el contrato real en cada build — ver la guarda openapi-snapshot si te interesa cómo.