Existen algunas prácticas recomendadas a tener en cuenta al diseñar las API, lo que garantiza la compatibilidad con versiones anteriores y las versiones nuevas. Cualquier enlace a artículos/blogs es apreciado.Diseño de la API que garantiza la compatibilidad con versiones anteriores
Debe consultar esta presentación sobre el diseño de API. Es de Google y es bastante bueno. También trata la compatibilidad con versiones anteriores y las nuevas versiones.
mantener ambos funcionando, con la versión en la url. api.mysite.com/[version]/api/url/here. Notifique a los usuarios cuando llegue una nueva versión de la API y elimine la versión anterior después de un tiempo. Ya sea cuando ya no se usa, o como 6 meses, asegurando que los usuarios tuvieron suficiente tiempo para cambiarlo.
O póngalo en funcionamiento para siempre, pero no entregue ninguna funcionalidad nueva para él.
Ese es básicamente el enfoque que he utilizado en múltiples proyectos. Otro patrón que he visto muy a menudo es hacer que 'api.example.com /' señale la última versión de la API: observe la falta de un número de versión. Los clientes que no desean lo último y lo mejor pueden acceder al URL versionado: 'api.example.com/v1 /' – Anurag
. Existe alguna discusión sobre si aún puede llamarlo una APLICACIÓN REST si incluye el control de versiones en el esquema de URL. . ver http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven o http://thereisnorightway.blogspot.com/2011/02/versioning-and-types-in-resthttp -api.html –
Gracias. Estos son más para versionar las API y su implementación. Me interesa saber si hay alguna guía sobre cómo exponer las API, qué sucede si el esquema de datos cambia (elimina/modifica algunos tipos de datos que están expuestos a través de la API, etc.) – Sampat
La mejor manera de hacer esto para que la interfaz de edad o clase en la nueva versión con nueva interfaz y las clases y los marcados como obsoletos (los medios se eliminará en futuras versiones).
El diseñador de la API Hear tiene en cuenta la diferencia entre la interfaz pública y la interfaz publicada.
http://lcsd05.cs.tamu.edu/slides/keynote.pdf << enlace roto :( – kinar
y aún así roto, ¿quizás este es el indicado? Http://static.googleusercontent.com/media/research. google.com/en//pubs/archive/32713.pdf – user180574
El enlace está roto. – Salar