Versionado, cambios y soporte

La versión va en la ruta (/api/v1). Dentro de v1 solo se añade: campos nuevos en las respuestas, parámetros opcionales y operaciones nuevas. Tu cliente debe ignorar los campos que no conozca.

Retirar o cambiar de sentido un campo es una v2, que convive con v1 el tiempo que se anuncie por escrito a las claves activas.

Escríbenos con la etiqueta de tu clave, la hora de la llamada y la respuesta recibida (nunca la clave). La especificación OpenAPI 3.1 en /api/v1/openapi.json sirve para generar clientes en cualquier lenguaje.