Se crea API porque quiere que la gente construya para ellos. Cuando la gente construye a sus API, que necesitan para seguir trabajando - incluso si / cuando las API deben evolucionar con el tiempo. La mejor manera de hacer esto es construir versiones de API a la derecha en las mismas direcciones URL de la API.
Sí: No se api.example.com/1.0/command~~V: api.example.com/command
Asumiendo que su código API se creó en control de código fuente usando un tronco estándar, etiquetas, estructura de ramas, una manera fácil de configurar esto es simplemente echa un vistazo a (exportación, etc.), la estructura de directorios etiquetas a su servidor web. Esto ata las versiones en las direcciones URL directamente a las versiones etiquetadas en su código.
Fuente estructura de código:
svn.example.com/api-code/tags/1.1
pueden ser exportados a su sitio web:
/ Var / www / api / ← esta es tu dir "etiquetas"
y el resultado en las direcciones URL como esta:
Otros consejos y sugerencias? Compartirlas en los comentarios.
Otros recientes-ish Mensajes de Nota en este sitio
.