Cambios

Cómo cambia el API, qué cuenta como cambio incompatible y dónde va a vivir el registro.

Qué puede cambiar sin aviso

• Endpoints nuevos, y campos opcionales nuevos en una solicitud existente.
• Campos nuevos en una respuesta: escribe un cliente que ignore lo que no reconoce.
• Tipos de evento nuevos, incluso dentro de una familia a la que ya estás suscrito con credential.*.
• Valores nuevos en un campo que ya está documentado como conjunto, como un estado de canal.

Qué no cambia dentro de `/v1`

• Un campo no se quita, no se renombra y no cambia de significado.
• Un tipo de evento no se renombra. Son parte del contrato público, y renombrar uno rompe la integración de un cliente.
• Un code de error se mantiene estable, y por eso tu software debe decidir sobre code y no sobre message.

Cualquier cosa que rompa una de esas se vuelve una versión nueva del API, no una edición silenciosa de esta.