Tu software, tus reservas.

La API de CocoBook da a un channel manager, un widget de reservas, una exportación contable o tu propio script acceso a las reservas, la disponibilidad y los precios de una propiedad. JSON de entrada y salida, claves de API con permisos, reintentos seguros y una descripción OpenAPI.

REST · JSONClaves por propiedad100 req/min

Inicio rápido

En CocoBook, abre Ajustes → Desarrolladores y crea una clave para la propiedad que quieres conectar. Elige los permisos que necesita; la clave solo se muestra una vez. Después comprueba que funciona:

Solicitud

curl https://api.cocobook.app/v1/me \
  -H "Authorization: Bearer cb_live_3fK9aBxQ7mNp2vLw8rTz4hJd6kYs1eCgU5oWnR0i"

Respuesta · 200

{
  "key": {
    "id": "a1c3e5f7-9b2d-4e6f-8a0c-2d4f6b8a0c1e",
    "name": "Channel manager",
    "prefix": "cb_live_3fK9aB",
    "scopes": ["bookings:read", "bookings:write"],
    "created_at": "2026-10-14T09:12:00Z",
    "expires_at": "2027-10-14T09:12:00Z"
  },
  "property": {
    "id": "7d2f8a1c-9e4b-4d6a-8c3f-1b5e7a9d2c60",
    "name": "Sea House",
    "currency": "EUR",
    "location": {
      "country": "BG",
      "country_name": "Bulgaria",
      "region": "Burgas",
      "town": "Sozopol",
      "label": "Sozopol, Bulgaria"
    },
    "image_url": "https://cocobook.app/static/uploads/properties/7d2f8a1c.jpg",
    "created_at": "2026-03-02T15:40:11Z"
  }
}

expires_at solo aparece si la clave tiene fecha de caducidad, e image_url solo si la propiedad tiene imagen. El mismo objeto property se devuelve en GET /property.

URL base: https://api.cocobook.app/v1. La descripción legible por máquina está en /v1/openapi.json: cárgala en Postman, Insomnia o un generador de SDK.

Autenticación y permisos

Cada solicitud lleva la clave en la cabecera Authorization como token bearer (también vale X-API-Key: cb_live_…). Una clave pertenece a una sola propiedad: no hay parámetro de propiedad, y cualquier cosa de otra propiedad simplemente devuelve 404. Solo los propietarios y administradores pueden crear y revocar claves; la revocación es inmediata.

PermisoPermite
bookings:readListar y leer reservas, disponibilidad y presupuestos
bookings:writeCrear, modificar y cancelar reservas; crear bloqueos
property:readLeer el perfil de la propiedad y sus unidades
property:writeModificar el perfil de la propiedad (nombre, moneda, ubicación)

Esto es lo que recibes si la credencial falta, es incorrecta o no tiene el permiso:

Sin clave · 401

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="cocobook-api"

{"error": {"code": "missing_api_key", "message": "Send the API key as 'Authorization: Bearer cb_live_…'."}}

Clave desconocida, revocada o caducada · 401

{"error": {"code": "invalid_api_key", "message": "The API key is not valid."}}

Clave sin el permiso · 403

{"error": {"code": "insufficient_scope", "message": "This key does not have the 'bookings:write' scope."}}

El 401 es deliberadamente idéntico para una clave revocada y para una que nunca existió. GET /me no necesita ningún permiso, así que es la llamada adecuada para un botón de «probar conexión».

Trata una clave como una contraseña: úsala desde tu servidor, nunca desde una página web o una app móvil, y da a cada integración su propia clave con los permisos mínimos que necesite.

Convenciones

  • JSON, UTF-8. Envía Content-Type: application/json. Los campos desconocidos se rechazan, para que las erratas aparezcan como 400.
  • Los ids son cadenas opacas. Las fechas son YYYY-MM-DD; check_out y todos los to son exclusivos (del 1 al 4 de junio son tres noches). Las marcas de tiempo son RFC 3339 en UTC.
  • Las listas llegan como {"data": […], "page", "per_page", "total"}; per_page hasta 200.
  • Los errores llegan como {"error": {"code", "message", "details"}}. details indica los campos problemáticos.
  • Los campos de texto opcionales (guest.email, guest.phone, notes, image_url, expires_at) se omiten en las respuestas cuando están vacíos, en lugar de enviarse como null.
  • No se cachea nada (Cache-Control: no-store). La versión va en la ruta; dentro de v1 solo se añaden campos.

Toda respuesta autenticada incluye las cabeceras de límite de peticiones, sea cual sea el estado:

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 37

Endpoints

EndpointPermisoQué hace
GET/me—La clave y su propiedad
GET/propertyproperty:readPerfil
PATCH/propertyproperty:writeCambiar nombre, moneda y ubicación
GET/units, /units/{id}property:readUnidades con capacidad, precio base y desayuno
GET/availabilitybookings:readRangos ocupados por unidad en un periodo
GET/quotebookings:readCalcular el precio de una estancia
GET/bookings, /bookings/{id}bookings:readListar con filtros, leer una
POST/bookingsbookings:writeCrear una reserva o un bloqueo
PATCH/bookings/{id}bookings:writeModificar cualquier campo
DELETE/bookings/{id}bookings:writeCancelar (también POST …/cancel)

Reservas

Los ejemplos siguientes acompañan a una reserva durante toda su vida: se crea para una estancia en julio, se lee, se amplía una noche y después se cancela. Todos usan la unidad «Sea view» de Propiedad y unidades.

Crear

Solicitud

curl -X POST https://api.cocobook.app/v1/bookings \
  -H "Authorization: Bearer cb_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8812" \
  -d '{
    "unit_id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47",
    "check_in": "2026-07-03",
    "check_out": "2026-07-06",
    "guest": {"name": "Ana Petrova", "email": "ana@example.com", "nationality": "BG"},
    "source": "booking_com",
    "breakfast_guests": 2,
    "deposit": 100
  }'

Obligatorios: unit_id, check_in, check_out, guest.name. status es confirmed por defecto (o envía pending; las reservas que el equipo acepta en el gestor sin depósito vuelven como deposit_pending, que retiene las fechas igual que confirmed); source es direct por defecto y puede ser direct, airbnb, booking_com, agoda o referral. Las estancias tienen como máximo 365 noches. Si omites price, la estancia se calcula a partir de las temporadas de la propiedad más el desayuno, exactamente como lo haría /quote. La respuesta es 201 con la reserva:

Respuesta · 201

{
  "id": "e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468",
  "code": "B-4762",
  "unit": {"id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "name": "Sea view"},
  "guest": {"name": "Ana Petrova", "email": "ana@example.com", "nationality": "BG"},
  "check_in": "2026-07-03",
  "check_out": "2026-07-06",
  "nights": 3,
  "status": "confirmed",
  "source": "booking_com",
  "price": 330,
  "deposit": 100,
  "currency": "EUR",
  "breakfast": {"guests": 2, "price": 30},
  "created_at": "2026-10-14T09:14:02Z",
  "updated_at": "2026-10-14T09:14:02Z"
}

price es el total de la estancia con el desayuno incluido (aquí 300 por la habitación más 30 por el desayuno); breakfast.price es esa línea por separado. code es la referencia corta que ve el equipo en CocoBook.

Si envías un campo que la API no conoce, o un JSON mal formado, se rechaza el cuerpo entero:

Respuesta · 400

{"error": {"code": "invalid_json", "message": "json: unknown field \"check_int\""}}

Un cuerpo bien formado con valores incorrectos indica todos los campos problemáticos a la vez, así que basta con una sola ida y vuelta para corregir un formulario:

Respuesta · 400

{
  "error": {
    "code": "validation_error",
    "message": "One or more fields are invalid.",
    "details": {
      "check_out": "must be after check_in",
      "guest.email": "must be a valid email address",
      "source": "must be direct, airbnb, booking_com, agoda or referral"
    }
  }
}

La unidad debe estar libre durante toda la estancia. La interfaz del gestor permite al equipo crear reservas solapadas y las marca como conflictos; la API, en cambio, las rechaza: 409 unit_unavailable cuando se solapa otra reserva activa y 409 unit_blocked cuando se solapa un bloqueo. details.conflicting_booking_ids indica cuáles:

Respuesta · 409

{
  "error": {
    "code": "unit_unavailable",
    "message": "The unit already has a booking overlapping these dates.",
    "details": {"conflicting_booking_ids": ["0b1c7d9e-5f3a-4b2c-8e6d-7a9f1c3e5b20"]}
  }
}

Reintentos seguros

Envía una cabecera Idempotency-Key (cualquier cadena única para ese intento, de hasta 255 caracteres) y un reintento tras un timeout devolverá la reserva creada la primera vez en lugar de un duplicado. Las claves se recuerdan durante 24 horas por clave de API. La repetición devuelve 200, no 201, y se marca con una cabecera:

La misma solicitud otra vez · 200

HTTP/1.1 200 OK
Idempotent-Replayed: true

{"id": "e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468", "code": "B-4762", …}

Solo se compara la clave, no el cuerpo, así que nunca reutilices una clave para un pedido distinto.

Bloqueos

Pon status a cleaning, owner o blocked para cerrar fechas sin huésped. En ese caso guest.name es opcional y el bloqueo nunca tiene precio, envíes lo que envíes:

Solicitud

POST /v1/bookings
{"unit_id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "check_in": "2026-07-06", "check_out": "2026-07-07", "status": "cleaning"}

Respuesta · 201

{
  "id": "c58a2f61-0d4e-4b9a-a3c7-6e1f8b2d9a05",
  "code": "BL-2210",
  "unit": {"id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "name": "Sea view"},
  "guest": {},
  "check_in": "2026-07-06",
  "check_out": "2026-07-07",
  "nights": 1,
  "status": "cleaning",
  "source": "direct",
  "price": 0,
  "deposit": 0,
  "currency": "EUR",
  "breakfast": {"guests": 0, "price": 0},
  "created_at": "2026-10-14T09:15:30Z",
  "updated_at": "2026-10-14T09:15:30Z"
}

Los bloqueos reciben un código BL- y un guest vacío. Tu equipo ve cada escritura de la API en las notificaciones de CocoBook, con el nombre de la clave.

Leer una

Solicitud

curl https://api.cocobook.app/v1/bookings/e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468 \
  -H "Authorization: Bearer cb_live_…"

Responde 200 con el mismo objeto de reserva que al crearla. Un id de otra propiedad, una errata o una fila eliminada dan la misma respuesta:

Respuesta · 404

{"error": {"code": "not_found", "message": "No booking with that id."}}

Listar y sincronizar

GET /v1/bookings?from=2026-07-01&to=2026-08-01            # bookings overlapping July
GET /v1/bookings?status=confirmed,pending&unit_id=b0e5…
GET /v1/bookings?updated_since=2026-10-14T09:00:00Z        # poll this for changes
GET /v1/bookings?include_blocks=true&page=2&per_page=100

Respuesta · 200

{
  "data": [
    {
      "id": "e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468",
      "code": "B-4762",
      "unit": {"id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "name": "Sea view"},
      "guest": {"name": "Ana Petrova", "email": "ana@example.com", "nationality": "BG"},
      "check_in": "2026-07-03", "check_out": "2026-07-06", "nights": 3,
      "status": "confirmed", "source": "booking_com",
      "price": 330, "deposit": 100, "currency": "EUR",
      "breakfast": {"guests": 2, "price": 30},
      "created_at": "2026-10-14T09:14:02Z", "updated_at": "2026-10-14T09:14:02Z"
    },
    {
      "id": "f7a0c3e2-6b1d-4a8f-9c5e-3d2b7f1a8e94",
      "code": "B-1183",
      "unit": {"id": "4f7a9c21-3b8d-4e6a-a1c5-2d9e8b7f6a10", "name": "Garden studio"},
      "guest": {"name": "Tom Weber", "phone": "+49 170 1234567", "nationality": "DE"},
      "check_in": "2026-07-10", "check_out": "2026-07-17", "nights": 7,
      "status": "pending", "source": "direct",
      "price": 560, "deposit": 0, "currency": "EUR",
      "breakfast": {"guests": 0, "price": 0},
      "notes": "Arrives after 22:00",
      "created_at": "2026-10-02T18:03:44Z", "updated_at": "2026-10-02T18:03:44Z"
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 2
}

Ordenadas por fecha de llegada. total cuenta todas las coincidencias en todas las páginas; page empieza en 1 y per_page es 50 por defecto. from y to seleccionan las reservas que se solapan con el periodo, no solo las que empiezan en él. Los bloqueos se omiten salvo que pongas include_blocks=true o que status los nombre. Las reservas canceladas siguen apareciendo en la lista con status: cancelled.

Una reserva que el equipo creó en CocoBook encima de otra vuelve con status: conflict; puedes filtrar por ese estado, pero la API nunca crea ninguna.

Para sincronizar, guarda la hora de tu última consulta y pide todo lo modificado desde entonces; una cancelación o una edición en CocoBook actualiza updated_at, así que aparece:

GET /v1/bookings?updated_since=2026-10-14T09:00:00Z&include_blocks=true&per_page=200

Modificar

PATCH acepta los mismos campos que la creación; solo cambian los que envías. Mover las fechas o la unidad vuelve a comprobar los solapamientos (las fechas de la propia reserva nunca cuentan) y, salvo que envíes un price, recalcula el precio de la estancia. Ampliar la estancia de Ana una noche:

Solicitud

curl -X PATCH https://api.cocobook.app/v1/bookings/e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468 \
  -H "Authorization: Bearer cb_live_…" \
  -H "Content-Type: application/json" \
  -d '{"check_out": "2026-07-07", "notes": "late arrival"}'

Respuesta · 200

{
  "id": "e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468",
  "code": "B-4762",
  "unit": {"id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "name": "Sea view"},
  "guest": {"name": "Ana Petrova", "email": "ana@example.com", "nationality": "BG"},
  "check_in": "2026-07-03",
  "check_out": "2026-07-07",
  "nights": 4,
  "status": "confirmed",
  "source": "booking_com",
  "price": 430,
  "deposit": 100,
  "currency": "EUR",
  "breakfast": {"guests": 2, "price": 40},
  "notes": "late arrival",
  "created_at": "2026-10-14T09:14:02Z",
  "updated_at": "2026-10-14T11:02:19Z"
}

Si el bloqueo de limpieza de antes siguiera ocupando el 6–7 de julio, la respuesta habría sido 409 unit_blocked. Envía "" para borrar guest.email, guest.phone o notes; para mantener el precio que negociaste al mover las fechas, envíalo también:

Solicitud

PATCH /v1/bookings/{id}
{"check_in": "2026-07-04", "check_out": "2026-07-08", "price": 400, "guest": {"email": ""}}

Cancelar

Solicitud

curl -X DELETE https://api.cocobook.app/v1/bookings/e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468 \
  -H "Authorization: Bearer cb_live_…"

Respuesta · 200

{
  "id": "e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468",
  "code": "B-4762",
  "status": "cancelled",
  "check_in": "2026-07-03",
  "check_out": "2026-07-07",
  "price": 430,
  "updated_at": "2026-10-15T08:30:00Z",
  …
}

POST /v1/bookings/{id}/cancel y PATCH con {"status": "cancelled"} hacen lo mismo. Al cancelar, la reserva se conserva con status: cancelled y se liberan sus fechas y su aparcamiento; cancelar dos veces no da problemas y vuelve a responder 200.

Disponibilidad y presupuestos

Disponibilidad

Solicitud

curl "https://api.cocobook.app/v1/availability?from=2026-07-01&to=2026-07-31&unit_id=b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47" \
  -H "Authorization: Bearer cb_live_…"

Respuesta · 200

{
  "from": "2026-07-01",
  "to": "2026-07-31",
  "units": [
    {
      "unit": {"id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "name": "Sea view"},
      "busy": [
        {"from": "2026-07-03", "to": "2026-07-06", "type": "booking", "status": "confirmed", "booking_id": "e394b1d0-2a6f-4c8e-b7d3-91f0a5c2e468"},
        {"from": "2026-07-06", "to": "2026-07-07", "type": "block", "status": "cleaning"},
        {"from": "2026-07-10", "to": "2026-07-14", "type": "external", "summary": "Airbnb (Not available)"}
      ]
    }
  ]
}

Todo lo que no está libre dentro del periodo, por unidad: reservas activas (type: booking, con el id para que puedas leerla), bloqueos y eventos external importados de los feeds iCal que conectó el propietario (Airbnb, Booking.com). Omite unit_id para obtener todas las unidades; una unidad sin nada tiene "busy": []. Periodos de hasta 366 días. Todo lo que no aparece está libre, incluidas las reservas canceladas.

Las dos fechas son obligatorias y el periodo debe ser de al menos un día:

Respuesta · 400

{"error": {"code": "validation_error", "message": "One or more fields are invalid.", "details": {"to": "range must be at most 366 days"}}}

Presupuesto

Solicitud

curl "https://api.cocobook.app/v1/quote?unit_id=b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47&check_in=2026-07-03&check_out=2026-07-06&breakfast_guests=2" \
  -H "Authorization: Bearer cb_live_…"

Respuesta · 200

{
  "unit": {"id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47", "name": "Sea view"},
  "check_in": "2026-07-03",
  "check_out": "2026-07-06",
  "nights": 3,
  "currency": "EUR",
  "room": 300,
  "breakfast": {"guests": 2, "price": 30},
  "total": 330,
  "per_night": [
    {"date": "2026-07-03T00:00:00Z", "rate": 90,  "season": "Summer", "weekend": false},
    {"date": "2026-07-04T00:00:00Z", "rate": 105, "season": "Summer", "weekend": true},
    {"date": "2026-07-05T00:00:00Z", "rate": 105, "season": "Summer", "weekend": true}
  ]
}

Por noche: la tarifa por unidad de la temporada si está definida (su variante de fin de semana en los días de fin de semana de la propiedad); si no, el precio base o de fin de semana de la unidad multiplicado por el multiplicador de la temporada; y si no, el precio base o de fin de semana sin más. season no aparece en las noches que quedan fuera de cualquier temporada. El desayuno es huéspedes × noches × la tarifa por persona de la unidad; una unidad sin desayuno siempre devuelve {"guests": 0, "price": 0}. total es room más breakfast.price, y una reserva creada sin precio recibe exactamente este total.

Un presupuesto no reserva nada ni comprueba la disponibilidad. El flujo habitual de un widget de reservas es /availability para mostrar las fechas libres, /quote para mostrar el precio, después POST /bookings, y tratar un 409 como «alguien ha sido más rápido».

Propiedad y unidades

Propiedad

Solicitud

curl -X PATCH https://api.cocobook.app/v1/property \
  -H "Authorization: Bearer cb_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Sea House", "currency": "EUR", "location": {"country": "BG", "region": "Burgas", "town": "Sozopol"}}'

Respuesta · 200

{
  "id": "7d2f8a1c-9e4b-4d6a-8c3f-1b5e7a9d2c60",
  "name": "Sea House",
  "currency": "EUR",
  "location": {
    "country": "BG",
    "country_name": "Bulgaria",
    "region": "Burgas",
    "town": "Sozopol",
    "label": "Sozopol, Bulgaria"
  },
  "image_url": "https://cocobook.app/static/uploads/properties/7d2f8a1c.jpg",
  "created_at": "2026-03-02T15:40:11Z"
}

Solo cambian los campos enviados, también dentro de location, así que {"location": {"town": "Chernomorets"}} mantiene el país y la región. GET /v1/property devuelve el mismo objeto. Monedas: EUR USD GBP TRY BGN RON CHF; country es un código ISO 3166-1 alfa-2; country_name y label se derivan y son de solo lectura. Un cambio de perfil actualiza al momento la web para huéspedes de la propiedad y su ficha en Explorar alojamientos. La imagen no se puede editar a través de la API.

Respuesta · 400

{"error": {"code": "validation_error", "message": "One or more fields are invalid.", "details": {"currency": "must be one of EUR, USD, GBP, TRY, BGN, RON, CHF", "location.country": "must be an ISO 3166-1 alpha-2 code"}}}

Unidades

Solicitud

curl https://api.cocobook.app/v1/units \
  -H "Authorization: Bearer cb_live_…"

Respuesta · 200

{
  "data": [
    {
      "id": "b0e562a3-7c1e-4f0a-9d2b-5e8f1a6c3d47",
      "name": "Sea view",
      "type": "apartment",
      "capacity": 2,
      "floor": "2",
      "base_price": 75,
      "weekend_price": 90,
      "breakfast": true,
      "breakfast_price": 5
    },
    {
      "id": "4f7a9c21-3b8d-4e6a-a1c5-2d9e8b7f6a10",
      "name": "Garden studio",
      "type": "studio",
      "capacity": 3,
      "floor": "",
      "base_price": 80,
      "weekend_price": 0,
      "breakfast": false,
      "breakfast_price": 0
    }
  ]
}

Las unidades son de solo lectura en la API y la lista no está paginada. base_price es la tarifa entre semana fuera de temporada y weekend_price la tarifa en los días de fin de semana de la propiedad; 0 significa lo mismo que base_price. breakfast_price es por persona y noche; 0 significa incluido. Las temporadas cambian lo que cuesta realmente una noche, así que usa /quote para obtener un precio real. GET /v1/units/{id} devuelve un único objeto de unidad; type puede ser studio, apartment, villa, room o loft.

Errores y límites

CódigoHTTPSignificado
missing_api_key401No se ha enviado ninguna credencial
invalid_api_key401Clave desconocida, revocada o caducada
insufficient_scope403La clave no tiene el permiso
validation_error400Un campo es incorrecto: consulta details
invalid_json400No es JSON, está vacío, supera los 64 KB o tiene campos desconocidos
not_found404El recurso no existe en esta propiedad
unit_unavailable409Se solapa otra reserva activa
unit_blocked409Se solapa un bloqueo
rate_limited429Más de 100 solicitudes en un minuto; espera Retry-After
internal_error500Error nuestro; vuelve a intentarlo más tarde

details aparece en validation_error (un mensaje por campo, los campos anidados como guest.email o location.country, y los parámetros de consulta por su nombre) y en los dos 409 (conflicting_booking_ids). Cualquier otro error contiene solo code y message.

Límite de peticiones

Cada clave puede hacer 100 solicitudes por minuto. El periodo es el minuto de reloj, compartido por todos nuestros servidores, y se reinicia al empezar el minuto siguiente, no 60 segundos después de tu primera llamada. Toda respuesta autenticada incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (segundos hasta que se reinicia el periodo); solo cuentan las solicitudes con una clave válida. La solicitud 101 de un periodo recibe:

Respuesta · 429

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 23

{"error": {"code": "rate_limited", "message": "Too many requests; at most 100 per minute per key."}}

Dosifica una importación masiva vigilando X-RateLimit-Remaining y, ante un 429, espera Retry-After segundos en lugar de reintentar enseguida.

Buenas prácticas

  • Una clave por integración, con su nombre y solo con los permisos que necesita. Revoca las claves que dejes de usar; pon fecha de caducidad a las claves temporales.
  • Consulta updated_since en lugar de volver a descargarlo todo.
  • Trata un 409 como un resultado normal: vuelve a leer /availability y ofrece otras fechas.
  • Reintenta los 429 después de Retry-After y los 5xx con espera progresiva, siempre con una Idempotency-Key en las creaciones.
  • Lee solo los campos que necesites y tolera los nuevos: dentro de v1 las respuestas ganan campos, nunca los pierden.

¿Tienes preguntas o un caso de uso que la API todavía no cubre? Escríbenos a hello@cocobook.app.