API Versioning & Deprecation Policy

This page is the deprecation policy for the Mini Bodegas San Pedro public read-only API. The API is versioned in the URL path. Deprecations are announced at least 90 days in advance through standard response headers and on this page.

Versioning

The version lives in the URL path (/api/v1/). The unversioned routes /api/units and /api/business are permanent aliases of the latest stable version. Backward-compatible changes, such as new response fields, land in v1 without notice. A breaking change ships as /api/v2/ without touching v1.

Deprecation and sunset

If an API version is scheduled for retirement, every response from that version carries the Deprecation header (RFC 9745) and the Sunset header (RFC 8594) at least 90 days before the sunset date. The retirement is also announced on this page and in the developer guide.

Current status: no API version is deprecated. The current stable version is v1.

OpenAPI specification: https://www.minibodegassanpedro.com/openapi.json
Developer guide: https://www.minibodegassanpedro.com/docs/

En español

Esta es la política de deprecación del API público de Mini Bodegas San Pedro. La versión va en la ruta (/api/v1/). Si una versión va a retirarse, sus respuestas llevan los encabezados Deprecation y Sunset al menos 90 días antes del retiro, y el retiro se anuncia en esta página. Hoy ninguna versión está deprecada.