Compatibilidad y versionado

Cada evento incluye api_version con el valor "v1". Prepare su integración para ignorar los campos que no reconozca: así seguirá funcionando si los eventos incorporan campos nuevos.

Versión del formato

Cada evento incluye el campo api_version en su estructura común.

Valor	Estado
v1	Versión vigente.

Cómo preparar su integración

Recomendación	Motivo
Lea solo los campos que necesita y no falle ante campos desconocidos.	Pueden aparecer campos nuevos.
No valide el cuerpo con un esquema que rechace propiedades adicionales.	Un esquema estricto fallaría cuando se agregue un campo.
No dependa del orden de las propiedades del JSON.	El orden de las propiedades de un objeto JSON no es significativo.
Verifique api_version y registre los valores que no reconozca.	Detecta a tiempo una versión nueva.

Ignore lo que no reconoce

Procese los campos que su integración usa y descarte el resto sin fallar. Lo mismo vale para los valores de event_type que no conozca: responda 2xx y regístrelos.

Siguiente paso

Revise las buenas prácticas.