Conceptos

Versionado y cambios

Qué puede cambiar dentro de v1 y el historial de cambios.

Ver en Markdown

La versión va en la ruta: /api/v1/. Dentro de v1 solo se agregan cosas: endpoints nuevos, campos nuevos en las respuestas o parámetros opcionales. Quitar un campo, cambiarle el significado o volver obligatorio algo que no lo era es una v2, que convive con v1 un tiempo anunciado.

Escribí tu integración tolerando campos desconocidos en las respuestas y códigos de error nuevos: tratá un código que no conocés según su recuperacion y reintentable.

La especificación completa está en openapi.yaml y openapi.json (OpenAPI 3.1).

Historial

1 de noviembre de 2026: v1

  • Catálogo, disponibilidad, crear reserva (con seña por Mercado Pago) y estado de una reserva.
  • Claves públicas con orígenes permitidos y claves secretas, con permisos por clave.
  • Idempotencia obligatoria al reservar, límites por minuto y formato común de errores.
  • Uso diario por clave en el panel. Incluida en el plan Enterprise.